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SUMMARY 


Part  I  User  Requirements  Analyzer 

♦  The  goal  of  Part  I  is  to  assist  the  User  Requirements  Analyzer  (URA) 

user  in  effectively  using  the  URA  Modifier  Commands  specified  in  Part  IV, 
"User  Requirements  Analyzer  Command  Descriptions."  This  part  illustrates 
the  usage  of  Version  A2.1  of  the  User  Requirements  Analyzer  and  specifies 
the  steps  in  creating  the  URA  data  base,  inputting  User  Requirements 
Language  (URL)  statements,  modifying  the  contents  of  the  data  base,  gen¬ 
erating  URA  outputs,  and  correcting  syntactical  and  logical  errors. 

Since  URA  is  used  in  conjunction  with  an  operating  system,  this 
part  should  be  used  in  conjunction  with  Part  II  which  presents  installa¬ 
tion  dependent  features  to  be  considered  when  using  URA.  This  part 
covers  installation  independent  features  of  URA,  general  concepts,  etc. 
Each  section  of  this  part  has  a  corresponding  section  in  Part  II.  This 
allows  easy  reference  between  general  concepts  and  the  actual  practice 
of  applying  them  in  a  particular  installation. 


Part  II  Usage  of  the  User  Requirements  Analyzer  under  Multics 

The  purpose  of  Part  II  is  to  assist  the  URA  user  in  effectively 
manipulating  the  URA  command  language  under  Multics.  This  part  covers 
those  installation  dependent  features  of  URA  and  is  intended  to  be  used 
in  conjunction  with  the  User  Requirements  Analyzer,  Part  I.  Each  sec¬ 
tion  of  this  part  has  a  corresponding  section  in  the  User  Requirements 
Analyzer.  This  part  illustrates  the  usage  of  Version  A2.1  of  the  User 
Requirements  Analyzer. 


Part  III  URA  Outputs 

The  goals  of  Part  III  are  to  assist  the  User  Requirements  Analyzer 
user  in  generating  reports  from  the  information  in  a  URA  data  base,  des¬ 
cribe  the  standard  reports  available  in  URA,  and  finally,  provide 
general  guidelines  on  using  these  reports  to  aid  in  the  logical  system 
design  process.  In  order  to  generate  the  reports  described  in  this  part 
it  is  necessary  to  understand  the  information  presented  in  Part  I  and 
Part  II  for  the  installation  in  which  URA  is  being  used.  It  is  also 
desirable  to  use  the  "User  Requirements  Analyzer  Commands  Descriptions" , 
Part  IV,  as  a  reference  for  a  better  understanding  of  the  URA  commands 
and  parameters  used  to  generate  a  particular  report. 

This  part  describes  those  URA  reports  available  in  Version  A2.1  of 
the  User  Requirements  Analyzer. 
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Part  IV  User  Requirements  Analyzer  Command  Descriptions 

The  objective  of  Part  IV  is  to  give  the  user  of  the  User  Require¬ 
ments  Analyzer  (URA)  the  list  of  the  commands  available,  the  correct 
syntax  of  these  commands,  and  the  parameters  allowable  for  each  command. 

This  part  is  not  intended  as  a  handbook  on  how  to  user  URA,  but  rather  as  * 

a  reference  for  the  commands  available.  Parts  I  and  II  describe  how  to 

use  these  commands  and  present  a  detailed  description  of  each  of  the 

outputs  generated  by  these  commands.  This  part  describes  the  facilities 

of  Version  A2.1  of  the  User  Requirements  Analyzer.  » 

The  manner  in  which  URA  directly  interfaces  with  the  Multics  oper¬ 
ating  system  is  given  in  Appendix  E.  Also  included  in  that  Appendix  is 
a  formal  description  of  the  URA  commands  available  only  under  that  par¬ 
ticular  operating  system. 


Part  V  Automated  Documentation  System  Users’  Manual 

The  objective  of  Part  V  is  to  provide  detailed  operating  instruc¬ 
tions  for  the  Automated  Documentation  System  (ADS) .  ADS  is  a  stand-alone 
program  and  file  structure  that  operates  on  a  URL  data  base  to  produce 
requirements  specifications  in  standard  formats  (e.g.  Mil  Std  483). 
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INTRODUCTION 


The  first  step  in  use  of  the  URL/URA  system  consists  of  specifying 
a  problem  statement  in  URL  statements.  The  second  step  consists  of 
using  URA  to  enter  the  problem  statement  into  a  computer  data  base. 
URA  extracts  information  from  the  URL  statements  and  stores  it  in 
a  URA  data  base.  Once  this  information  (a  problem  statement)  is  in 
the  data  base,  it  can  be  modified,  new  information  can  be  added  to 
it,  and  reports  presenting  the  status  of  the  problem  statement  can 
be  generated.  These  actions  are  implemented  by  the  URA  commands 
available  in  the  ura  (processing)  mode.  This  mode  of  operation  may 
be  attained  by  accessing  the  URA  software  available  on  a  particular 
operating  system.  Therefore,  by  understanding  the  operating  commands 
that  interact  with  URA  and  the  URA  command  language,  the  problem 
definer  (user)  can  effectively  manipulate  the  contents  of  a  URA 
data  base.  Part  I  serves  as  a  guide  to  using  the  URA  commands. 

Operating  system  and  URA  commands  can  only  be  used  in  their  respec¬ 
tive  (processing)  modes.  Operating  System  commands  can  be  used 
from  time  of  signing  on  to  the  system,  to  the  time  access  to  the 
URA  software  is  acquired.  At  this  point,  onlyjRA  commands  may  be 
used  until  the  problem  definer  returns  control  to  the  operating 
system  or  terminates  processing  to  be  done  in  URA  mode  (through 
use  of  the  URA  "STOP"  command) .  Operating  system  commands  then 
can  again  be  used  up  to  the  time  of  signing  off.  This  interaction 
between  operating  system  and  URA  modes  is  illustrated  by  Figure  1. 

The  first  five  sections  of  Part  I  deal  with  URA  at  an  introduc¬ 
tory  level.  Section  2  presents  introductory  information  about  the 
use  of  URA  Section  3  explains  the  procedure  of  initializing  URA 
once  on  the  operating  system.  Sections  4  and  5  present  practical 
concepts  and  conventions  to  be  known  before  using  URA.  (Once  access 
to  URA  has  been  achieved,  various  commands  are  available;  these 
commands  are  described  in  Sections  6,  7  and  8.)  Several  examples 
are  given  in  these  sections  in  order  to  better  illustrate  the 
results  of  specific  implementations.  Sections  9  and  10  deal  with 
handling  errors  encountered  in  the  use  of  URA.  Appendix  A  presents 
a  list  of  all URA  commands  available  (and  the  parameters  for  each 
command)  as  well  as  the  abbreviations  for  all  these  to  serve  as  a 
quick  reference.  Throughout  Part  I  the  long  forms  of  URA 
commands  and  parameters  are  used  interchangeably  with  their 
abbreviations . 


Figure  1:  Interaction  between  Operating  System  and  URA 
processing  modes 
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2.  USING  URA 


2.1  The  URA  Command  Language 


The  URA  Command  Language  commands  may  be  grouped  into  three  major  types. 

« 

Control  Commands 

Control  Commands  are  used  to  pass  certain  control  information  to 
the  User  Requirements  Analyzer.  These  commands  are  operating 
system  dependent  and  are  given  in  PartT  IX. 

The  use  of  these  commands  does  not  change  the  contents 
of  the  data  base. 

Modifier  Commands 


Modifier  Commands  are  used  to  modify  the  contents  of  the  URA 
data  base  in  the  manner  defined  by  the  problem  definer.  These 
commands  take  legal  URL  statements  or  url  names  as  input.  URA 
then  generates  error  diagnostics  as  well  as  an  output  report 
to  present  the  outcome  of  the  data  base  alteration. 

Report  Commands 

Report  Commands  retrieve  data  from  the  URA  data  base  and  output 
'w  it  in  some  standard  format.  These  reports  do  not  change  the 

contents  of  the  data  base  whatsoever.  Their  purpose  is  solely 
that  of  displaying  some  or  all  of  the  contents  of  the  data  base. 

2.2  Command  Parameters 


Most  URA  commands  have  parameters  which  may  be  set  by  the  user 
to  modify  the  actions  of  the  command.  There  are  basically  five 
types  of  parameters: 

Input  data  parameters  -  these  parameters  specify 

the  data  to  be  used  as  input  to  the  command. 

INPUT,  FILE  and  NAME  are  examples  of  Input  data 
parameters. 

Input  control  parameters  -  these  parameters  specify  how 
the  input  data  is  to  be  used,  changed,  etc.,  by 
the  command.  The  TYPE  parameter  for  the  CHANGE-, 
TYPE  command  and  CONTAINED/CONSISTS  parameter  for 
the  CONSISTS-MATRIX  command  are  examples  of  this 
type. 


Output  data  parameters  -  these  parameters  specify  if 
output  is  to  be  generated  from  the  command  and 
the  form  In  which  it  is  presented.  The  PUNCH 
and  PRINT  parameters  are  examples  of  this  type 
of  parameter. 
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Output  option  parameters  -  these  parameters  specify 
options  which  may  be  included  or  omitted  from 
the  output.  The  LEVELS  parameter  for  the 
CONTENTS  command  and  the  DESCRIPTION  parameter 
for  the  DICTIONARY  command  are  examples  of 
this  type. 

Output  format  parameters  -  these  parameters  specify 
alternate  formats  for  presenting  the  infor¬ 
mation  in  the  output  from  the  command.  The 
NEW-PAGE  parameter  and  HMARG  parameter  for 
the  FPS  command  are  examples  of  this  type. 


2.3  NAME-GEN  Command 


Although  all  of  the  commands  can  be  issued  independently  of  each 
other,  it  is  often  advantageous  to  use  some  commands  in  sequence 
since  the  output  of  one  command  may  be  used  as  input  by  another. 
The  most  common  instance  of  this  is  when  NAME-GEN  is  used  to 
select  certain  names  (say  all  PROCESSES  for  example)  which  can 
then  be  used  as  input  to  a  Report  Command  (possibly  PICTURE, 
for  a  PICTURE  REPORT  for  all  PROCESS  names).  Though  NAME-GEN 
is  technically  classified  as  a  Report  Command  one  of  its  major 
functions  is  to  selectively  retrieve  names  stored  in  the  data 
base.  For  more  information  about  use  of  this  command,  see 
"  URA  Outputs"*  and  "URA  Command  Descriptions."** 

2.4  The  HELP  Command 


The  HELP  Command  provides  the  user  with  information  about  the 
syntax  and  parameters  of  URA  commands.  The  HELP  command  does  not 
affect  the  manner  in  which  URA  operates  nor  accesses  information  in 
the  data  base.  For  this  reason,  it  is  not  classified  as  a  Con¬ 
trol,  Modifier  or  Report  Command.  When  the  HELP  Command  is 
given,  URA  displays  a  list  of  all  available  URA  commands  and 
their  abbreviations.  3y  specifying  a  particular  URA  command 
name  as  a  parameter  to  the  HELP  command: 

HELP  CONTENTS 

for  example,  all  the  parameters  available  for  this  command  will 
be  printed.  If  the  "LONG"  parameter  were  given  in  conjunction 
with  a  command  name: 


*Part  HI 

**  _  ,  __ 

Part  IV 
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HELP  FPS  LONG 

all  parameters  for  the  FORMATTED-PROBLEM-STATEMENT  Command  would 
be  printed  out  as  well  as  a  description  of  the  function  of  each 
of  these  parameters  for  the  command.  This  description  is 
presented  in  the  same  format  as  that  in  "  USER  REQUIREMENTS 
ANALYZER  COMMAND  DESCRIPTIONS".*  To  illustrate  an  example, 
when  "HELP  CONTENTS"  was  given  the  following  information 
was  printed: 

CONTENTS 

Prototype:  CONTENTS (CONT)  [parameter]  ... 

Parameters : 

FILE[=fdname] ,  NAME(N)=user  name 
INDEX,  NOINDEX 
LEVELS=integer ,  LEVELS=ALL 
NCFLAG,  NONCFLAG 


Default:  FILE 
Default:  NOINDEX 
Default:  ALL 
Default :  NONCFLAG 
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THE  URA  ENVIRONMENT 


The  considerations  necessary  for  using  URA  and  preparing  for 
using  URA  define  the  URA  environment.  The  following  points 
must  be  considered: 

-  How  the  data  base  is  prepared. 

-  How  URA  is  executed  . 

-  How  URA  is  used. 

-  How  batch  use  of  URA  is  different  from  terminal  use. 

The  first  three  points  are  presented  in  section  3.1,  "Initiating 
URA,"  and  the  last  point  is  presented  in  section  3.2,  "Batch 
Versus  On-line  Use  of  URA."* 

3.1  Initiating  URA 

-  The  steps  required  to  prepare  a  URA  data  base  for  access  by 
URA  are: 

i)  The  URA  data  base  file  must  be  created. 

Creation  of  the  data  base  file  occurs  only  once.  Once 
created,  any  changes  to  be  made  (including  emptying 
the  whole  file)  can  be  made  without  destroying  it. 

ii)  The  data  base  must  then  be  initialized  in  order  to  be 
accessed  by  URA. 

Initialization,  for  the  most  part,  occurs  only  once, 
at  the  time  of  creating  the  data  base.  The  data  base 
must  be  reinitialized  if  emptied. 

-  Executing  URA  involves  running  the  URA  program.  This  allows  the 
user  to  specify  URA  commands  to  change  the  contents  of  the  data 
base  or  generate  reports  about  its  contents. 

-  Once  the  URA  program  has  been  invoked  the  following  steps 
are  suggested  in  using  URA  : 

i)  The  data  base  to  be  accessed  by  the  URA  commands 
must  be  specified. 

This  should  be  done  any  time  URA  is  used  to  ensure 
that  the  user  is  accessing  the  correct  data  base. 

In  some  cases  the  data  base  to  be  used  will  set 
by  default  any  time  the  user  executes  ura-  Even 
if  this  is  the  case,  the  user  should  be  aware  that 
the  default  is  in  effect. 


*  The  exact  commands  to  carry  out  the  above  procedures  are 

installation-dependent  and  can  be  found  in  Part  II  (Section  3»1). 
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ii)  URA  commands  are  given  to  modify,  update  and/or  generate 
reports  on  the  data  base  information. 

Any  of  the  commands  given  in  '“User  Requirements  Analyzer 
Command  Descriptions"*  can  be  issued  to  accomplish  these 
tasks.  The  order  in  which  commands  are  given  and  which 
commands  are  given  is  determined  by  the  user. 

iii)  The  STOP  command  is  given  to  terminate  the  URA  session. 

3.2  Batch  Versus  On-line  Use  of  URA 


The  manner  in  which  a  user  interacts  with  URA  via  batch  processing 
differs  from  on-line  (terminal)  usage.  There  are  various 
advantages  and  disadvantages  to  either  approach.  A  few  of  these 
are  given  in  Table  1 . 

The  procedures  given  in  Section  3.1  are  the  same  for  both  on-line 
and  batch  use  of  URA.  The  specific  manner  in  which  URA  commands 
are  given  by  the  user,  however,  is  different. 

In  batch  processing  of  URA  commands,  URA  commands  are  given,  one 
per  card,  following  the  card  which  executes  the  URA  program.  Any 
errors  detected  in  specifying  the  command  (or  its  parameters)  cause 
the  command  to  be  ignored,  and  URA  then  moves  to  the  next  command. 

When  executing  URA  in  on-line  mode,  the  user  must  wait  for  the 
message: 


ENTER  COMMAND  (AND  ANY  PARAMETERS) 

before  giving  any  commands.  After  typing  in  the  command  followed 
by  a  carriage  return,  the  user  must  wait  again  until  the  command 
prompting  message  is  issued  before  entering  the  next  command.  If 
an  error  occurs  when  specifying  the  command  (or  its  parameters)  the 
user  will  be  prompted  for  a  replacement. 


*  Part  IV 
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user  is  able  to  handle  errors  as  they  -  Requires  the  URA  user  to  think  out 

ir.  Errors  can  be  corrected  before  procedures  (list  of  URA  commands)  to 

attempt  is  made  to  modify  or  retrieve  be  executed  before  they  are  executed 
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Table  1.  Comparison  of  Outline  versus  Batch  Use  of  URA 


4 


SPECIFYING  INPUT  TO  URA  COMMANDS 


For  most  URA  commands  one  or  more  names  (specified  by  the 
uuer)  can  be  used  as  "input"  to  the  command.  This  can  be  done 
by  utilizing  the  "input  data"  parameters  for  the  command.  In 
the  case  of  Modifier  Commands,  the  modification  is  made  for 
each  name  used  as  input.  For  Report  Commands,  information  is 
.retrieved  for  each  of  the  names  used  as  input.  Except  for 
the  INPUT-PSL  command,  all  names  used  as  input  to  the  Modifier 
and  Report  Commands  must  be  names  already  stored  in  the  problem 
definer's  URA  data  base. 

4 . 1  The  NAME  Parameter 

There  are  two  methods  of  specifying  names  to  be  input  to  a 
command.  The  simplest  way  is  to  use  the  NAME  parameter.  When 
this  parameter  is  used,  the  modification  will  be  made,  or  report 
will  be  generated,  for  only  that  name  specified  by  the  NAME 
parameter.  For  example,  if  NAME=T-CARD  were  used  for  the 
DELETE  command,  only  T-CARD  would  be  deleted  from  the  data  base. 
Likewise,  if  NAME=T-CARD  were  used  as  a  parameter  for  the  CONTENTS 
command,  the  CONTENTS  REPORT  would  be  generated  for  the  name 
T-CARD,  and  no  others. 

4.2  The  FILE  and  INPUT  Parameters 


The  second  way  to  specify  names  as  input  to  a  URA  command  is  to 
put  all  the  names  for  which  the  modification  is  to  be  made,  or 
report  generated,  into  a  file  and  specify  that  the  contents  of 
that  file  are  to  be  used  as  input.  At  most  installations  this 
specification  can  simply  be  done  via  the  FILE  and  INPUT  parameters, 
but  varies  slightly  from  one  installation  to  the  next.  (See 
Part  II,  Section  4.)  FILE  and  INPUT  are 

different  in  the  way  names  can  be  formatted  within  the  file 
specified  by  these  parameters.  When  using  the  FILE  parameter, 
each  name  in  the  specified  file  must  begin  in  the  first  column 
of  each  line  of  the  file  and  only  one  name  per  line  is  allowed. 

The  format  for  files  specified  by  the  INPUT  parameter  varies 
according  to  the  URA  command  using  this  parameter.  For  example, 
if  a  file  is  used  as  input  to  the  INPUT-PSL  command,  the  file 
must  consist  of  URL  statements  to  be  entered  into  the  URA  data 
base.  For  those  Modifier  Commands  that  allow  the  INPUT  parameter, 
the  particular  format  needed  for  the  input  file  is  specified  in 
the  description vOf  each  command. 


If  one  particular  file  name  is  used  throughout  a  given  terminal 
session  to  contain  various  information  and  name  lists  to 
Interact  with  URA  commands,  the  user  should  remember  to  empty 
the  file  before  each  time  new  data  is  to  be  written  into  it. 
Otherwise,  information  used  as  input  to  a  previous  command  may  be 
loftover  when  using  the  file  with  subsequent  commands. 
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4. 3  Entering  Data  Into  an  Input  File 


The  manner  in  which  data  is  entered  into  a  file  is  installation- 
dependent,  Part  II  ,  Section  4,  for 

the  details  of  this  procedure, 

4-4  Us  ins  NAME-GEN 

One  alternative  to  specifying  input  to  Modifier  and  Report 
Commands  is  to  let  NAME-GEN  generate  the  input  file.  The  various 
parameters  for  NAME-GEN  allow  selection  of  particular  types  of 
names  that  are  desired  (e.g.,  all  GROUPS  and  ENTITIES)  and 
retrieval  of  these  names  which  are  then  put  into  a  file  by  URA. 
The  names  are  formatted,  one  name  per  line  starting  in  the  first 
column  of  the  line.  The  contents  of  this  file  can  be  used  as 
input  to  a  Report  Command  or  Modifier  Command.  For  example, 
by  specifying: 


NAME-GEN  ENTITY  GROUP 
CONTENTS 

in  sequence,  the  CONTENTS  REPORT  will  be  generated  for  all  ENTITY 
and  GROUP  names  in  the  URA  data  base.  In  addition,  the  contents 
of  the  file  produced  by  NAME-GEN  are  maintained  until  the  next 
NAME-GEN  is  issued. 

4.3  Using  PUNCH  Files 

PUNCH  files  are  files  which  have  formats  acceptable  by  FILE  or 
INPUT  parameters.  The  file  described  in  the  previous  section  is 
a  PUNCH  file  from  the  NAME-GEN  command.  Output  from  NAME-GEN  is 
put  into  its  assigned  PUNCH  file  so  that  it  may  be  used  as  input 
to  any  of  the  FILE  parameters  for  Modifier  and  Report  Commands. 

The  PUNCH  file  format  is  different  from  the  report  format  for  the 
command  that  generates  both  of  them.  For  example,  upon  execution 
of  the  NAME-GEN  command  for  all  PROCESSES,  the  report  generated 
will  consist  of  a  report  heading,  line  numbers  for  the  contents 
of  the  report,  the  names  of  all  PROCESSES  in  the  data  base  and 
their  corresponding  name  type  (which  is,  of  course,  PROCESS).  The 
contents  of  the  PUNCH  file  produced  by  this  command  will  only 
contain  the  names  of  the  PROCESSES,  without  report  headings,  etc. 
In  other  words,  the  PUNCH  file  contains  similar  information  to  the 
report  output  from  the  command,  but  in  a  format  acceptable  to  the 
FILE  and  INPUT  parameters  of  other  URA  commands. 

At  most  installations,  the  PUNCH  file  to  be  used  (name  of  the 
file)  can  be  specified  by  the  PUNCH  parameter  for  the  command. 

The  manner  of  assignment  varies  slightly  from  one  installation  to 
the  next.  (See  Part  II  .  Section  4.)  Specific 

usage  of  the  PUNCH  parameter  is  given  in  the  descriptions  of 
the  individual  commands  that  utilize  this  parameter.  The  specific 
names  of  the  PUNCH  files  used  can  be  found  in  Appendix  E. 
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5.  RECEIVING  OUTPUT  FROM  URA  COMMANDS* 


Several  URA  commands  allow  the  user  to  specify  whether  output  is 
generated  from  the  command  or  not.  This  is  done  via  the  "output 
data"  parameters  for  the  particular  command.  When  generating 

outputs  from  URA,  the  information  is  put  into  a  file  or  printed  r 

on  a  device  such  as  a  line  printer  or  terminal.  If  this  file  or 
device  is  not  specified  then  all  outputs  are  written  to  the 
main  output  file  or  device.  This  means  that  output  will  be 

written  on  the  terminal  when  in  conversational  mode  and  on  the  % 

line  printer  when  running  batch.  There  are  several  reasons  why 
outputs  might  be  routed  elsewhere,  especially  for  on-line 
processing: 

-  Large  quantities  of  output  would  take  too  long  to  be 
printed  at  the  terminal. 

-  Depending  on  the  type  of  terminal,  some  portions 

of  the  output  may  not  be  printed  because  of  physical 
restrictions  imposed  by  the  terminal. 

-  The  handling  of  printout  from  the  terminal  can  sometimes 
be  awkward  and  the  format  not  aesthetically  pleasing. 

-  No  copy  of  the  output  is  desired.  (Only  the  PUNCH  file 
may  be  needed  as  a  step  in  a  modification  procedure). 

i 

Most  methods  of  receiving  and  controlling  output  from  URA. 
commands  are  installation  dependent  and  therefore  given  in 

Part  II,  Section  5. 

5.1  The  NOPRINT  Parameter 

Several  URA  commands  allow  the  option  of  not  having  the  output 
printed  via  the  NOPRINT  parameter.  The  commands  that  allow  this 
parameter  are: 

DELETE-COMMENT-ENTRY  (DCOM) 

FORMATTED-PROBLEM-STATEMENT  (FPS) 

NAME-GEN  (NG) 

PRINT- COMMENT- ENTRY  (PCOM)  m 

PROCESS-INPUT-OUTPUT  (PRIO) 

REPLACE-COMMENT-ENTRY  (RCOM) 

The  two  Modifier  Commands  RCOM  and  DCOM  have  this  parameter 
available  because  the  printout  can  be  fairly  large  and  may  not 
be  needed  for  future  reference.  The  report  heading  for  the 
RCOM  or  DCOM  output  and  any  error  diagnostics  are  still 
printed  to  provide  a  hard-copy  record  of  the  command  execution. 


*  Thi i,  section  only  deals  with  receiving  outputs  in  the  form  of 
reports  (as  specified  in  Part  III).  Receiving 

output  as  presented  via  the  PUNCH  parameter  is  discussed  in  the 
previous  section.  24 


’'w  The  remaining  four  Report  Commands  can  use  this  parameter  in 

conjunction  with  the  PUNCH  parameter.  The  option  of  the 
NOPRINT  parameter  is  provided  because  when  PUNCH  information  is 
desired,  there  may  be  no  need  for  the  printout. 

,  5.2  The  INDEX  Parameter 

Several  commands  allow  the  user  to  specify  that  an  index 
(alphabetic  listing  of  names  used)  for  the  report  be  generated 
by  the  command.  The  index  also  specifies  the  pages  on  which 
these  names  occur  in  the  report.  This  is  done  by  specifying 
INDEX  as  a  parameter  for  the  command.  The  commands  which  allow 
this  parameter  are: 

CONTENTS 

DICTIONARY 

EXTENDED-PICTURE 

FORMATTED-PROBLEM-STATEMENT 

PICTURE 

PROCESS-CHAIN 

PROCESS-INPUT-OUTPUT 

STRUCTURE 

5.3  The  NOSOURCE  and  XREF  Parameters 

\w  The  NOSOURCE  and  XREF  parameter  have  the  same  function  for  the 

INPUT-PSL  and  DELETE-PSL  commands  as  the  NOPRINT  and  INDEX 
parameter  for  other  URA  commands.  The  report  produced  by 
XREF,  however,  (the  URA  CROSS  REFERENCE  LISTING)  specifies  the 
lines  rather  than  the  pages  where  the  names  occur  . 
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6.  CONTROL  COMMANDS 


All  control  commands  are  installation-dependent.  For  this  reason 
all  control  commands  available  to  a  particular  installation  and 
the  descriptions  and  usage  of  these  commands  are  given  in  Section 

6  of  Part  XX. 
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7.  MODIFIER  COMMANDS 


All  the  commands  in  this  section  modify  the  URA  data  base  in  some 
manner  and  generate  an  output  to  present  the  result  of  the 
modification.  These  outputs  provide  the  user  with  a  permanent 
record  of  changes  made  to  the  problem  statement  in  the  data  base. 

Effect  of  Modifier  Commands  on  the  Data  Base  Structure 

There  are  basically  three  types  of  information  stored  in  a  URA 
data  base: 

1)  Names  and  types  of  objects  defined  by  the  user 

2)  Comment  entries  (narrative  and  free  format  descriptions  of 
objects) 

3)  Connections  among  objects  and  between  an  object  and  comment 
entry 

All  this  information  is  entered  into  the  data  base  via  INPUT-PSL 
from  the  URL  statements  used  as  input  to  this  command.  In  most 
cases  the  section  header  statements  define  the  type  of  objects  and 
names  of  the  objects,  comment  entry  statements  (DESCRIPTION,  for 
example)  define  comment  entries  to  be  stored,  and  other  URL  state¬ 
ments  define  relationships  or  connections  among  the  named  objects 
in  the  data  base.  To  present  the  structure  of  the  data  base  in  a 
graphical  manner,  the  following  symbols  will  be  used: 


c 


symbol  for  record  used  to  describe  a 
given  named  object  (name  record) 


symbol  for  comment  entry  stored  in  data  base 


symbol  for  a  NUB,  a  type  of  record  used  to  make 
connections  among  objects  and  between  an  object 
and  comment  entry 
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Using  the  above  notation,  a  simple  relationship  between  two  objects 
(name  recojrds)  may  look  like: 


CZD 


Data  in  the  NUB  defines  the  type  of  connection  (RECEIVES,  for 
example)  and  the  direction  of  the  arrows  defines  the  manner  in 
which  the  relationship  should  be  interpreted,  i.e.,  which  object 
does  the  RECEIVING. 

A  connection  between  an  object  and  a  comment  entry  may  look  like: 


The  data  in  the  NUB  defines  the  type  of  comment  entry  (PROCEDURE, 
for  example). 

It  is  important  to  note  that  the  connections  made  among  objects 
are  different  from  the  connection  made  between  an  object  and  comment 
entry. 

INPUT-PSL  creates  records  for  named  objects,  the  NUB  records 
connecting  the  objects,  and  the  comment  entries.  Commands  must 
also  be  available  to  do  the  following: 

1)  Change  a  name  record 

i)  change  the  name  of  the  object 
ii)  change  the  object  type 

2)  Delete  a  connection  between  objects 

3)  Delete  a  name  record  (and  any  connections  it  had  with 
other  objects) 

A)  Change  a  comment  entry 

5)  Delete  a  comment  entry 

URA  has  facilities  to  perform  all  of  these  modifications  on  the 
data  base  information.  The  following  URL  commands  perform  the 
actions  corresponding  to  the  above: 


1)  Change  a  name  record: 


i)  Change  the  name  of  an  object: 

RENAME  -  This  command  changes  information  , 

within  the  name  record  only. 

ii)  Change  the  object  type: 

CHANGE- TYPE  -  This  command  changes  information 

within  the  name  record  only. 

2)  Delete  connections  among  objects: 

DELETE-PSL  -  This  command  deletes  NUBS  (and 

thus  connections)  among  name  records 
in  the  data.  It  does  not  delete 
name  records  or  comment  entries. 


3)  Delete  name  records: 

DELETE  “  This  command  deletes  name  records. 

Names  to  be  deleted  having  connections 
with  other  names  and/or  having  comment 
entries  associated  with  them,  will  have 
corresponding  NUBS  (and  comment  entries) 
deleted. 

4)  Change  comment  entries: 

REPLACE-COMMENT-ENTRY 

-  This  command  changes  information  within 
the  comment  entry  only. 

5)  Delete  comment-entries: 

DELETE-COMMENT-ENTRY 

—  This  command  deletes  comment  entries  and  also 
deletes  corresponding  NUBS. 

Modifier  Command  Description  Format 

Each  Modifier  Command  will  be  described  in  the  following  format: 

Command  name  (command  abbreviation) 

When  specifying  the  command  to  be  executed,  either  the  long 
form  of  the  command  name  or  legal  abbreviations  of  the  name 
may  be  given. 

Modification  made 


All  Modifier  commands  change  information  in  the  URA  data  base. 
What  type  of  information  is  changed  and  how  it  is  changed  is 


described.  Also,  the  checks  made  by  URA  before  the  change  is 
made  are  presented. 

Output  description 

All  Modifier  commands  generate  an  output  to  present  the  result 
of  the  modification (s)  made.  The  name  of  the  output,  purpose  of 
the  output,  contents,  and  diagnostics  given  in  the  output  are 
presented  to  aid  in  using  it. 

Execution 


The  basic  form  of  specifying  the  command  to  be  executed  is 
described.  An  example  of  how  this  is  done  and  the  results 
from  the  action  are  given. 

Options  and  Alternatives 

All  Modifier  commands  can  be  executed  in  more  than  one  way. 

For  example,  a  different  form  of  the  command  may  be  used  to 
change  one  name  in  the  data  base  versus  a  number  of  names. 

Also,  the  effect  which  the  parameters  for  the  command  have  on 
modifying  the  data  base  is  described.  Examples  are  given  to 
illustrate  the  alternatives. 

Commmon  Errors 

It  is  possible  to  make  particular  errors  in  the  use  of  each 
Modifier  command.  Some  of  the  particular  logical  and  syntactical 
errors  that  occur  when  executing  the  command  are  given. 

The  following  commands  are  described  in  this  section  in 
alphabetical  order: 


,7.1  CHANGE-TYPE 

7 . 2  DELETE 

7 . 3  DELETE-COMMENT-ENTRY 
7. A  DELETE-PSL 

7.5  INPUT-PSL 

7 . 6  PUNCH-COMMENT- ENTRY 

7.7  RENAME 

7 . 8  REPLACE-COMMENT-ENTRY 
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7.1  CHANGE-TYPE  (CT) 


Modification  Made 


Each  name  specified  as  input  to  this  command  has  its  corresponding 
name  type  changed  if  the  new  type  does  not  conflict  with  the 
context  in  which  the  name  has  previously  been  used.  This  modifi¬ 
cation  is  most  often  used  to  change  an  undefined  name  {***  UNDEFINED  ***) 
to  a  specific  name  type  (such  as  GROUP  or  ELEMENT) .  Various 
"checking"  facilities  must  be  used  to  ascertain  that  legal  changes 
are  being  made.  For  each  name  type  change,  URA  must  check  to  see 
that : 

i)  The  name  whose  name  type  is  to  be  changed  exists  in  the 
data  base. 

ii)  The  assignment  of  the  new  name  type  is  consistent  with 
the  context  in  which  the  name  was  used  previously. 

Output  description 

The  output  generated  by  this  command  is  the  CHANGE-TYPE  REPORT. 

This  report  presents  for  each  name  used  as  input  to  the  CHANGE- 
TYPE  command,  the  name,  the  old  name  type  associated  with  it  and 
the  new  name  type  now  assigned  to  it.  Any  error  diagnostics  which 
may  occur  during  the  name  type  change  will  also  be  printed. 

The  names  are  printed  out  in  the  same  order  in  which  they  were 
read  as  input  to  the  CHANGE- TYPE  command. 

Execution 

To  change  the  name  type  of  only  one  name,  the  following  command 
format  is  issued: 

CHANGE- TYPE  NAME=gross-pay  TYPE=ELEMENT 

Previously  in  the  problem  statement,  "gross-pay"  had  been  defined 
as  a  GROUP.  It  was  more  appropriate  to  call  it  an  ELEMENT,  and 
the  CHANGE- TYPE  command  made  it  easy  to  facilitate  this  change. 

The  resulting  CHANGE- TYPE  REPORT  is  shown  in  Figure  2. 

Options  and  Alternatives 

1.  The  name  types  of  several  names  can  be  changed  at  one  time 
if  the  names  are  put  into  a  file  and  the  file  is  specified 
as  input  to  the  command.*  (This  is  usually  done  via  the 
FILE  parameter.) 


*  The  exact  manner  in  which  the  file  is  specified  is  given  in 

Part  II,  Section  7.1. 
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n—  Figure  3  is  an  output  resulting  from  using  a  file  as 

input  to  CHANGE-TYPE.  All  the  names  in  the  example  are 
shown  to  have  been  previously  undefined  (not  assigned  a  name 
type).  The  report  shows  that  "date"  was  changed  to  a  GROUP, 
"employee-date"  became  a  GROUP,  and  "valid-t-card"  an  ELEMENT. 
Each  line  of  the  input  file  consists  of  the  name  of  an  object 
>  followed  by  the  new  name  type  to  be  assigned  to  it.  The 

format  is  acceptable  if  the  name  is  followed  by  its  new  name 
type  and  the  two  are  within  the  first  eighty  columns  of  the 
file  line  and  there  is  at  least  one  blank  between  them.  The 
»  file  used  to  generate  Figure  3  was: 

date  GROUP 
employee-data  GROUP 
valid-t-card  ELEMENT 

2.  The  TYPE  parameter  can  also  be  used  effectively  with  an 
input  file.  All  names  in  the  input  file  will  have  their 
name  types  changed  to  the  name  type  specified  by  the  TYPE 
parameter.  If  the  file  from  the  previous  example  was 
specified  as  input  and  the  TYPE  parameter  was  also  used, 
only  the  names  in  the  file  would  be  read  as  input:  the  name 
types  would  be  ignored.  All  the  names  specified  in  the  input 
file  would  have  their  name  types  changed  to  that  given  by 

the  TYPE  parameter.  Figure  4  presents  the  output  resulting 
w  from  a  CHANGE-TYPE  command  with  TYPE-ELEMENT  and  the  file 

used  as  input  the  same  as  that  used  for  Figure  3« 

3.  It  is  sometimes  advantageous  to  use  NAME-GEN  in  conjunction 
with  CHANGE-TYPE,  i.e.,  use  the  output  produced  by  NAME-GEN 
as  input  to  CHANGE-TYPE.  This  is  most  often  done  when  all 
names  of  a  particular  type  (usually  UNDEFINED)  are  changed  to 
another  type  (GROUPS  or  ELEMENTS).  To  change  all  undefined 
names  in  the  data  base  to  GROUPS: 

NAME-GEN  UNDEFINED 
CHANGE-TYPE  FILE  TYPE=GROUP 

The  NAME-GEN  command  selects  all  undefined  names  and  places 
them  in  a  file.  The  CHANGE-TYPE  command  then  uses  the  file 
produced  by  NAME-GEN  as  its  input  file.  The  TYPE=GROUP  parameter 
specifies  that  all  the  names  in  the  input  file  should  be 
changed  to  GROUPS.  Figure  5  presents  the  result  of  this 
.  procedure. 

Common  Errors 


If  neither  an  input  file  nor  NAME  is  specified  for  the  command, 
the  message:  "NO  NAME  GIVEN"  will  be  printed  by  URA  .  If  a 
file  or  NAME  is  given,  but  no  name  types  arc  given  in  the  file 
or  no  TYPE  is  given,  the  message:  "NO  TYPE  GIVEN  WITH  "NAME=" 
OR  "FILE"  PARAMETER  will  be  printed.  Should  either  of  these 
messages  be  generated,  URA  will  not  execute  the  CHANGE-TYPE 
command.  The  command  and  its  parameters  should  be  re  entered 
with  the  necessary  corrections. 
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Another  common  error  is  attempting  to  assign  a  new  name  type  to  a 
name  that  has  previously  been  used  in  a  way  that  conflicts  with  its 
new  name  type.  For  example,  if  the  name  XYZ  was  previously  defined 
to  be  CONTAINED  in  SET  SI,  this  would  imply  that  XYZ  must  be  either 
an  ENTITY,  INPUT  or  OUTPUT.  If  an  attempt  was  made  to  change  its 
type  to  a  GROUP  (which  cannot  be  CONTAINED  in  a  SET)  the  error 
message: 

URA030 : CHKREL:  CONFLICT  WITH  EXISTING  CONNECTIONS 

would  be  given  and  the  change  would  not  be  made.  If  it  is  still 
desired  that  XYZ  be  a  GROUP,  XYZ  should  be  deleted  from  the  data 
base  and  proper  URL  statements  for  XYZ  should  be  entered  via 

INPUT-PSL.  All  conflicting  connections  are  listed.  They  all  must  be 
resolved  before  the  change  of  type  can  occur. 
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7.2  DELETE  (DEL) 


Modification  Mule 

For  each  name  specified  as  input  to  the  DELETE  command,  all  its 
relationships  (i.e.,  USES,  SUBPARTS,  etc.),  with  other  names  in 
the  data  base  arc  removed,  its  comment  entries  (such  as 
DESCRIPTION  or  PROCEDURE)  are  deleted  and  finally  the  name  is 
deleted  from  the  data  base.  Before  any  of  these  modifications 
are  made,  URA  checks  that  the  name  to  be  deleted  exists  in  the 
data  base.  If  the  name  cannot  be  found,  no  attempt  will  be  made  by 
URA  to  delete  t  he  name. 

Output  Description 

The  DELETION  RY'PORT  is  produced  each  time  this  command  is 
initiated.  Each  name  used  as  input  to  the  DELETE  command  is 
printed  on  the  report  along  with  the  status  of  the  change 
(i.e.,  if  it  did  or  did  not  work).  The  names  on  the  output 
appear  in  the  same  order  as  read  by  the  DELETE  command. 

This  report  serves  as  a  permanent  record  of  names  that  have 
been  deleted  from  the  URA  data  base.  It  is  intended  to  aid  the 
analyst  in  keeping  track  of  modifications  to  the  data  base.  Once 
there  is  a  record  of  a  particular  name  being  deleted,  the  analyst 
has  the  option  of  re-using  the  name. 

Execution 

The  following  command  deletes  one  name  from  the  data  base: 

DELETE  N- V\'^=field-check-new 

The  DELETION  Iv&PORT  for  this  action  is  shown  in  Figure  6# 
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Options  and  Alternatives 


1.  Several  names  can  be  deleted  from  the  data  base  if  the  names 
are  put  into  a  file  and  the  file  is  specified  as  input  to  the 
command.*  (This  is  usually  done  via  the  FILE  parameter.) 

The  format  of  the  input  file  consists  of  one  name  per  line, 
beginning  in  column  one.  Figure  7  is  an  output  resulting 
from  using  a  file  as  input  to  the  DELETE  command.  All  the 
names  in  the  report  had  been  defined  in  the  data  base.  The 
report  shows  that  deletion  of  each  name  was  successful. 

Common  Errors 


DELETE  should  not  be  used  to  delete  the  entire  contents  of  the 
data  base.  Operating  system  command  should  be  utilized  for  this 
procedure.  The  data  base  should  be  emptied  and  then  reinitialized. 

When  doing  minor  editing  of  a  URL  description  for  a  name  in  the 
data  base  the  information  connected  to  that  name  ( URL  statements) 
should  be  saved  before  deleting  the  name.  A  FORMATTED-PROBLEM- 
STATEMENT  for  the  name  should  be  generated  using  the  PUNCH  para¬ 
meter.  Then  the  name  can  be  deleted  (via  DELETE)  from  the  data 
base.  At  this  point,  the  old  information  in  the  PUNCH  file  can 
be  edited  to  suit  the  problem  definer  and  *  then  re-entered  via 
the  INPUT-PSL  command  using  the  PUNCH  file  produced  by  the  FPS 
as  input. 

If  a  file  is  used  as  input  to  the  command,  all  names  to  be 
deleted  must  begin  in  the  first  column  of  the  file  line.  Any 
preceding  blanks  will  be  interpreted  as  part  of  the  name. 

If  neither  an  input  file  nor  NAME  is  specified  for  the  command, 
the  message:  "NO  NAME  OR  FILE  WAS  SPECIFIED"  will  be  printed  by 
URA#  Should  this  happen,  URA  will  not  execute  the  DELETE  command. 
The  command  and  its  parameters  should  be  reentered  with  the 
necessary  corrections . 


* 


*  The  exact  manner  in  which  the  file  is  specified  is  given  in 

Part  II,  Section  7.2. 
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Figure  7 


7.3  DELETE-COMMENT-ENTRY  (DCOM) 


Modification  Made 


The  DELETE-COMMENT-ENTRY  takes  those  names  specified  as  input 

and  deletes,  for  each  input  name,  the  comment  entries  associated  * 

with  those  comment  entry  types  designated  as  command  parameters.* 

If  no  comment  entry  types  are  specified  by  the  parameters,  no 
comment  entries  will  be  deleted.  Checking  is  performed  to  see  if 
the  comment  entry  exists  in  the  data  base  before  it  is  deleted. 

If  the  comment  entry  cannot  be  found,  no  attempt  is  made  to  delete  it.  * 

Output  description 

The  output  report  generated  by  this  command  is  called  DELETED 
COMMENT  ENTRIES.  For  each  comment  entry  to  be  deleted  from  the 
data  base,  the  following  information  is  printed  on  the  output: 

-  name  in  the  data  base  to  which  the  comment  entry  belonged. 

-  the  type  of  comment  entry  (i.e.,  DESCRIPTION,  PROCEDURE, 
etc.)  which  is  being  deleted. 

-  the  full  text  of  the  comment  entry. 

The  order  of  the  output  names  is  the  same  as  the  order  of  the  input 
names . 

This  serves  as  a  hard  copy  record  for  those  comment  entries  deleted 
from  the  system  description.  As  stated  before,  it  is  desirable 
to  have  all  modifications  to  the  system  description  documented. 

Execution 

The  following  command  deletes  the  PROCEDURE  comment  entry  associated 
with  one  name. 

DCOM  NAME=new-info-validation  PROCEDURE 

This  was  done  because  the  problem  definers  wanted  to  delete 
current  PROCEDURE  comment  entry  and  did  not  want  to  replace  it. 

If  the  comment  entry  could  be  correct  if  edited  or  a  replacement 
was  available,  then  it  would  be  more  appropriate  to  use  the 

REPLACE- COMMEN T- EN TRY  command  (see  section  7.8).  The  output  w 

generated  by  this  command  is  shown  in  Figure  8. 

Options  and  Alternatives 

1.  Multiple  comment  entries  can  be  deleted  for  a  name: 

DCOM  NAME=new-info-validation  PROCEDURE  DESCRIPTION 

111  this  case,  the  PROCEDURE  and  DESCRIPTION  comment  entries 
would  be  deleted  for  the  PROCESS,  "new-inf o-validation. " 

*  An  example  of  a  comment  entry  type  is  a  URL  "DESCRIPTION "  or 
"PROCEDURE"  statement.  The  comment  entry  associated  with  this 
comment  entry  type  would  he  the  text  specified  by  the  user 
for  the  particular  statement. 
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2.  The  following  types  of  comment  entries  can  be  deleted  when 
specified  as  parameters  for  DELETE-COMMENT- ENTRY: 

DERIVATION 

DESCRIPTION 

FALSE-WHILE 

PROCEDURE 

TRUE- WHILE 

VOLATILITY 

VOLATITY-MEMBER 

VOLATILITY-SET 

3.  Several  names  can  have  their  comment  entries  deleted  if  the 
names  are  put  into  a  file  and  the  file  is  specified  as  input. 
The  comment  entries  deleted  for  these  names  are  those 
specified  as  parameters  for  the  command.  If  the  user 
specifies  that  the  DESCRIPTION  and  PROCEDURE  comment  entries 
be  deleted  for  a  GROUP  name,  the  DESCRIPTION  comment  entry 
will  be  deleted  and  the  message: 

URA104 : DELSET :  PROCEDURE  COMMENT-ENTRY  NOT  FOUND 


will  be  given  because  GROUPS  may  not  have  PROCEDURE  statements. 

Figure  9  shows  the  output  resulting  from  executing  the 
DELETE-COMMENT-ENTRY  command  with  a  file  of  names  as  input 
and  DESCRIPTION  and  PROCEDURE  comment  entry  types  as  parameters . 
The  example  shows  for  each  name  used  as  input,  each  comment 
entry  deleted  for  the  name. 

4.  Printing  of  the  DELETED  COMMENT  ENTRIES  output  may  be 
suppressed  by  specifying  NOPRINT  as  a  parameter: 

DCOM  NAME=pay roll-processing  DESCRIPTION  NOPRINT 
Common  Errors 


If  neither  an  input  file  nor  NAME  is  specified  for  the  command, 
the  message  "NONAME  OR  FILE  SPECIFIED"  will  be  printed  by  URA- 
Should  this- happen,  ura  will  not  execute  the  DELETE- COMMENT- 
ENTRY  command.  The  command  and  its  parameters  should  be  reentered 
with  the  necessary  corrections. 
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7.4  DELETE-PSL  (DPSL) 


Modification  Made 


This  command  takes  as  input,  any  URL  statements  in  the  format 
specified  in  the  "User  Requirements  Language,  Version  3.0 
Language  Reference  Manual."*  For  each  section  header  statement 
(i.e.,  PROCESS,  DEFINE,  etc. 2),  all  the  URL  statements  following 
this  section  header  (up  to  the  next  section  header  statement) 
will  be  deleted  from  the  URA  data  base  for  those  names  specified 
in  the  header  statement.  This  command  only  deletes  relationships 
between  names  and  does  not  delete  any  comment  entries  (this  is 
handled  by  the  DCOM  command) nor  deletes  names  (this  is  handled  by  the 
DELETE  command) .  If  some  of  the  information  presented  by  the  URL 
statements  is  contradictory,  an  error  message  will  be  given  for  that 
statement.  Error  diagnostics  are  also  given  when  syntactical  errors 
occur.  URA  attempts  to  continue  the  procedure  until  too  many  errors 
are  encountered. ^ 

Output  Description 

The  two  outputs  that  may  be  generated  by  this  command  are  DELETED 
URL  and  the  URA  CROSS  REFERENCE.  The  DELETED  URL  output  is  a 
record  of  all  information  (except  names  and  comment  entries)  deleted 
from  the  URA  data  base.  It  aids  the  analyst  in  finding  errors 
in  the  deletion  procedure  and  produces  error  diagnostics  in 
sufficient  detail  to  aid  the  analyst  in  correcting  these  errors. 

This  output  displays,  line  for  line,  the  data  used  as  input  to 
the  DELETE-PSL  command.  No  reordering  is  done  on  the  input  data. 

The  URA  CROSS  REFERENCE  is  intended  as  an  aid  to  the  analyst  in 
correcting  errors  that  appear  in  the  DELETED  URL  output.  It 
consists  of  an  alphabetical  list  of  all  user  defined  names,  i.e., 
non-URL  names  that  appear  in  the  DELETED  URL  output.  For  each 
name  that  appears  in  the  CROSS  REFERENCE,  its  corresponding 
name  type  (as  given  in  the  DELETED  URL  output)  is  printed  and  a 
list  of  all  lines  in  the  DELETED  URL  output  where  the  name  appeared 
is  also  given. 

Execution 


The  most  common  method  of  deleting  URL  statements  is  by  first 
writing  all  statements  to  be  deleted  into  a  file  (or  punching 
them  on  cards)  and  then  using  this  as  input  to  the  command.*  (This 


ISDOS  Working  Paper  No.  68. 

Sec  Appendix  F  of  ISDOS  Working  Paper  No.  68  for  a  complete 
list  of  all  possible  section  header  types. 

Sec  Section  9  for  the  limit  of  errors  allowed. 


+ 


The  exact  manner  in  which  the  file  can  be  specified  is  given 

in  Part  II,  Section  7.4. 


c 


is  usually  done  via  the  INPUT  parameter.)  Only  the  first  72 
columns  of  each  line  in  the  file  may  contain  URL  statements. 

Anything  after  column  72  is  ignored.  Figure  10  is  the  output 

resulting  from  this  type  of  procedure.  The  EOF  statement  must 
be  given  to  specify  the  end  of  URL  statements  to  be  deleted. 

Options  and  Alternatives 

1.  In  many  cases  when  the  amount  of  input  is  relatively  large 

(a  few  hundred  lines) ;  hence,  there  may  be  a  need  for  the  URA 
CROSS  REFERENCE.  It  will  be  generated  by  specifying  the  XREF 
parameter  with  the  command. 

2.  If  no  input  file  is  specified,  URA  will  wait  for  URL  statements 
to  be  typed  in  (from  the  terminal),  or  when  in  batch  mode, 
interpret  any  following  cards  up  through  the  first  "EOF”  as 
URL  statements  to  be  deleted.  When  URL  statements  are  entered 
at  the  terminal,  each  line  entered  is  echoed  back  by  URA  along 
with  any  errors  encountered  for  that  statement  (i.e.  an  AS-IS 

SOURCE  LISTING).  This  allows  the  user  to  correct  errors  as  they  occur. 

3.  Printing  of  the  DELETED  URL  output  may  be  suppressed  by 
specifying  NOSOURCE  as  a  parameter. 

Common  Errors 


The  most  common  errors  are  typing  errors  encountered  in  inter¬ 
preting  the  URL  statements.  A  typing  mistake  can  cause  many 
different  types  of  syntactical  and  semantic  errors. 

Only  the  first  72  columns  of  each  line  in  the  input  file  are 
read  so  all  URL  statements  should  fit  in  this  region.  Anything 
over  column  72  will  be  truncated  and  an  error  message  will  be 
generated  in  most  cases. 

Omitting  the  semicolon  at  the  end  of  a  URL  statement  is  a  common 
cause  for  several  errors. 

DELETE-PSL  will  not  delete  comment  entry  statements  from  the  data 
base  so  these  statements  are  ignored  if  encountered  in  the  input 
file.  No  names  other  than  SYNONYMS  can  be  deleted  from  the  data 
base  via  DELETE-PSL. 

The  last  line  of  the  input  file  containing  the  URL  statements 
should  have  the  word  EOF  signifying  the  end  of  input.  This  should 
also  be  typed  when  inputting  the  data  interactively.  EOF  allows 
the  return  to  the  URA  command  handler.  No  URL  statements  are  read 
after  EOF. 
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Figure  10 


7.5  INPUT-PSL  (IP) 


Modification  Made 


This  command  takes  as  input,  any  URL  statements  in  the  format 
specified  in  "User  Requirements  Language,  Version  3.0,  Language 
Reference  Manual. For  each  section  header  statement  (i.e., 
PROCESS,  DEFINE,  etc. 2)  the  user  defined  names  specified  by 
that  section  header  will  be  added  to  the  list  of  names  in  the 
data  base  (if  not  already  in  the  data  base).  All  the  URL  statements 
following  this  section  header  up  to  the  next  section  header  state¬ 
ment,  specify  connections  to  be  made  with  other  names  in  the  data 
base.  URA  first  performs  syntax  and  semantic  checks  on  each  input 
line  before  any  more  complex  checking  is  performed.  An  "in 
context"  check  is  made  for  each  name  used  as  input.  If  the  name 
is  not  in  the  user’s  data  base,  it  is  added.  If  it  is,  a  check 
is  made  to  see  that  the  context  in  which  the  name  is  used  in  the 
new  input  agrees  with  the  manner  in  which  the  name  is  used  in 
the  data  base.  If  there  is  a  conflict,  an  error  message  will  be 
produced  and  URA  will  skip  to  the  next  input  statement.  URA 
attempts  to  continue  the  input  procedure  until  too  many  errors 
are  encountered.-*  If  redundant  information  is  given,  i.e., 
specifying  the  same  relationship  more  than  once,  the  redundant 
information  will  not  be  added  to  the  information  already  in  the 
data  base.  No  diagnostic  message  is  given  to  denote  redundant 
information. 

Output  Description 

The  two  outputs  that  may  be  generated  by  this  command  are  the 
URA  AS-IS  SOURCE  LISTING  and  the  URA  CROSS  REFERENCE.  The  URA 
AS-IS  SOURCE  LISTING  is  a  record  of  all  information  input  into  the 
URA  data  base,  and  is  intended  as  an  aid  to  the  analyst.  It  aids 
the  analyst  in  finding  errors  in  the  input  data  and  produces  error 
diagnostics  in  sufficient  detail  to  aid  the  analyst  in  correcting 
these  errors.  The  output  displays,  line  for  line,  the  data  used 
as  input  to  the  INPUT-PSL  command.  The  order  of  the  input  data 
is  not  changed. 

The  URA  CROSS  REFERENCE  is  intended  as  an  aid  to  the  analyst  in 
correcting  errors  that  appear  in  the  URA  AS-IS  SOURCE  LISTING 
and  also  to  resolve  ambiguities  in  assigning  name  types  to  the 
undefined  names  in  the  listing.  It  is  useful  in  correcting  errors, 
as  any  name  involved  in  an  error  can  be  quickly  referenced  to 
find  all  places  in  the  AS-IS  LISTING  where  the  name  is  used,  and 
the  name  type  assigned  to  that  name. 


ISDOS  Working  Paper  No.  68. 

See  Appendix  F  of  Working  Paper  No.  68  for  a  complete  list  of 
all  possible  section  header  types. 

See  Section  9  for  the  limit  of  error  allowed. 


From  this  information,  the  analyst  will  be  able  to  determine  what 
information  has  to  be  reentered  to  correct  the  error.  Since  the 
CROSS  REFERENCE  also  presents  all  those  names  which  have  an 
ambiguous  name  type  (one  that  was  not  defined  in  previous  input), 
the  analyst  can  resolve  those  ambiguities  by  use  of  the  CHANGE-TYPE 
or  INPUT-PSL  commands.  The  output  consists  of  an  alphabetical 
list  of  all  user  defined  names,  i.e.,  non-URL  names,  that  appear 
in  the  AS-IS  LISTING.  For  each  name  that  appears  in  the  CROSS 
REFERENCE,  its  corresponding  name  type  (as  given  in  the  AS-IS 
LISTING)  is  printed  and  a  list  of  all  lines  in  the  AS-IS  LISTING 
where  the  name  appeared  is  also  given. 

Execution 

The  most  common  method  of  inputting  URL  statements  is  by  first 
writing  all  statements  to  be  added  into  a  file  (or  punching  them  on 
cards)  and  then  using  this  as  input  to  the  command.*  (This  is 
usually  done  via  the  INPUT  parameter.)  Note  that  only  the  first 
72  columns  of  each  line  in  the  file  may  contain  URL  statements. 

Anything  after  72  is  ignored.  Figure  11  is  the  output  resulting 
from  this  type  of  procedure.  The  EOF  statement  must  be  given  to 
specify  the  end  of  URL  statements  to  be  added.  The  UPDATE  parameter 
specifies  that  the  URA  data  base  is  to  be  modified  by  the  input. 

If  this  parameter  is  not  given,  none  of  the  information  will  be 
added  to  the  data  base. 

Options  and  Alternatives 

1.  In  many  cases,  when  the  amount  of  input  is  relatively  large 
(a  few  hundred  lines)  there  may  be  a  need  for  the  URA  CROSS 

REFERENCE.  By  simply  specifying  XREF  as  a  parameter, 
it  will  be  generated.  Figure  12  presents  an  AS-IS  LISTING 
and  CROSS  REFERENCE  for  a  small  problem  statement. 

2.  In  most  cases,  it  is  advantageous  to  first  do  a  syntax  and 
semantic  check  of  the  input  data  before  attempting  to  put 

it  in  the  data  base.  By  not  specifying  the  UPDATE  parameter, 
these  checks  will  be  made  without  actually  putting  the  information 
into  the  data  base.  This  will  generate  an  AS-IS  LISTING  with  error 
diagnostics  for  the  URL  statements  used  as  input.  Since 
most  problem  statements  have  one  or  two  typing  errors  anyway, 
this  proves  to  be  an  inexpensive  way  to  catch  errors  early. 

After  the  source  of  the  errors  has  been  determined  and  corrected, 
the  command  can  be  issued  again  using  UPDATE  as  a  parameter. 

3.  If  no  input  file  is  specified,  URA  will  wait  for  URL  statements 
to  be  typed  in  (from  the  terminal) ,  or  when  in  batch  mode, 
interpret  any  following  cards  up  through  the  first  "EOF"  as 
URL  statements  to  be  added  to  the  data  base.  When  URL  state¬ 
ments  arc  entered  at  the  terminal,  each  line  entered  is  echoed 
back  by  URA  along  with  any  errors  encountered  for  that 
statement  (i.e.,  an  AS-IS  SOURCE  LlSliNG).  This  allows  the 
user  to  correct  errors  as  they  occur. 


*  The  exact  manner  in  which  the  file  can  be  specified  is  given 

in  Part  II,  Section  7.5. 


4. 


Printing  of  the  AS-IS  SOURCE  LISTING  may  be  suppressed  by 
specifying  NOSOURCE  as  a  parameter. 

5.  The  DBREF  parameter  allows  referencing  of  the  data  base  when 

semantic  as  well  as  syntax  checks  are  desired  for  URL  statements  used 
as  input.  This  must  be  in  effect  when  UPDATE  is  given  as  a 
parameter.  NODBREF  may  be  specified  if  only  a  syntax  check 
of  the  statements  is  desired  and  the  data  base  is  not  to  be 
updated. 

Common  Errors 


The  most  common  errors  are  typing  errors  encountered  in  interpreting 
the  URL  statements.  A  typing  mistake  can  cause  so  many  different 
types  of  syntactical  and  semantic  errors  that  it  will  be  handled 
in  a  later  section  (Section  10) . 

It  is  also  possible  to  input  the  new  information  into  the  wrong 
data  base.  It  is  important  that  the  data  base  to  be  used  has 
been  specified.  Otherwise,  the  data  base  may  be  set  to  some 
default  which  may  not  be  the  data  base  file  desired. 

The  INPUT-PSL  command  only  reads  the  first  72  columns  of  each 
line  in  the  input  file  so  all  URL  statements  must  fit  in  this 
region.  Anything  over  column  72  will  be  truncated  and  an  error  message 
will  be  given  in  most  cases. 

Omitting  the  semicolon  at  the  end  of  a  URL  statement  is  a  common 
cause  for  several  errors.  It  is  important  that  the  syntax  of 
each  URL  statement  be  correct. 

The  last  line  of  the  input  file  containing  the  URL  statements  should 
have  the  word  EOF  signifying  the  end  of  input.  This  should  also 
be  typed  when  inputting  the  data  interactively.  EOF  allows  the 
return  to  the  URA  command  handler.  (See  Figures  11  and  12 
to  see  how  EOF  is  used  correctly.)  No  URL  statements  are  read  after 
EOF. 
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7.6  PUNCH-COMMENT- ENTRY  (PCOM) 


Modification  Made 

i 

Technically,  the  output  produced  by  this  command  is  a  report 
presenting  narrative  information  in  the  manner  of  a  glossary. 

It  makes  no  modifications  to  the  data  base,  but  is  presented 
here  because  its  main  objective  is  to  aid  the  analyst  in  changing 
comment  entries  in  conjunction  with  the  REPLACE-COMMENT-ENTRY 
command.  The  idea  of  using  the  output  as  a  glossary  (for  final 
specifications  perhaps)  however,  should  not  be  overlooked.  A 
message  is  given  when  no  comment  entry  is  available  for  a 
particular  comment  entry  type  or  the  name  specified  is  not  in  the 
data  base. 

Output  Description 

The  PUNCHED  COMMENT  ENTRIES  output  is  generated  by  this  command. 
It  presents  selected  comment  entries  for  each  name  used  as 
input  to  the  command.  Any  type  of  name  may  be  used  as  input  to 
the  command.  Depending  on  the  type  of  name  the  following  comment 
entries  may  be  retrieved: 


DERI VAT ION 

(DER) 

DESCRIPTION 

(DESC) 

FALSE -WHILE 

(FW) 

PROCEDURE 

(PRCD) 

TRUE -WHILE 

(TW) 

VOLATILITY 

(VOL) 

VOLATILITY-MEMBER 

(VOLM) 

VOLATILITY-SET 

(VOLS) 

For  each  name  used  as  input  to  the  command,  the  name  is  printed 
on  the  output  in  the  order  in  which  it  was  read  and 
associated  with  that  name,  the  type  of  comment  entry  and  the 
text  for  that  comment  entry  ffor  each  type  of  comment  entry  as 
specified  in  the  parameter  list). 

Execution 


To  obtain  the  DESCRIPTION  comment  entry  for  one  name  the 
following  command  might  be  given: 

PCOM  NAME=payrol 1-processing  DESCRIPTION 

This  will  generate  the  report  show  in  Figure  13.  A  PUNCH 
file  will  also  be  generated  with  the  same  information  as  the 
report.  The  manner  in  which  the  file  to  contain  the 
PUNCH  data  is  specified  is  installation  dependent  and  given  in 
Part  II,  Section  7.0.  If  t he  procedure 

is  done  at  the  terminal,  the  PUNCH  file  can  then  be  edited  and 
used  as  input  to  the  RE PLACE- COMMENT- ENTRY  command  to  modify 
the  comment  entry.  If  the  procedure  is  done  in  batch,  the  contents 
of  the  PUNCH  file  produced  should  be  punched  on  cards  fby  the 
system  if  possible).  Then  the  deck  of  cards  produced  can  be 
modified  and  used  as  input  to  REPLACE -COMMENT- ENTRY  in  the  next 
batch  run.  __  ^ 
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Options  and  Alternatives 


1.  Several  names  can  have  comment  entries  printed  and/or  PUNCHED 
if  the  names  are  put  into  a  file  and  the  file  is  specified 

as  input  to  the  command.*  (This  is  usually  done  via  the  FILE 
parameter.)  Figure  14  is  an  output  resulting  from  using  a 
file  as  input  to  the  PCOM  command. 

2.  Multiple  comment  entries,  such  as  DESCRIPTION  and  PROCEDURE, 
can  be  generated  for  several  names  when  a  file  is  specified 
as  input  and  more  than  one  comment  entry  type  is  specified 
as  parameters.  This  is  illustrated  in  Figure  15. 

3.  When  the  objective  of  executing  this  command  is  to  generate 
a  PUNCH  file,  printing  of  the  report  may  be  suppressed 

by  issuing  NOPRINT  as  a  parameter. 

4.  When  the  objective  of  executing  this  command  is  to  generate 
the  report  (and  no  PUNCH  data  is  desired) ,  production  of 
data  in  the  PUNCH  file  may  be  suppressed  by  issuing  NOPUNCH 
as  a  parameter. 

5.  The  NAME-GEN  can  also  be  used  in  conjunction  with  PCOM  to 
retrieve  all  names  of  a  particular  name  type  (such  as  INTERFACE) 
to  be  used  as  input  to  the  PCOM  command.  For  example: 

NAME-GEN  INTERFACE 
PCOM  DESCRIPTION 

This  procedure  retrieves  all  INTERFACE  names  defined  in  the 
data  base  and  produces  the  PUNCHED  COMMENT  ENTRIES  report  for 
all  these  names  and  their  corresponding  DESCRIPTIONS.  This 
could  also  be  done  for  more  than  one  type  of  name: 

NAME- GEN  SET  PROCESS 
PCOM  DESCRIPTION  PROCEDURE 


Notice  that  the  PROCEDURE  parameter  is  given,  but  SETS  cannot  have 
PROCEDURE  statements  associated  with  them.  Only  the  DESCRIPTION 
statements  will  be  retrieved  for  SET  names  while  both  DESCRIPTION 
and  PROCEDURE  statements  will  be  retrieved  for  PROCESS  names. 

Common  Errors 


The  problem  de finer  should  note  that  most  of  the  parameters 

indicating  comment  types  (i.e.,  FALSE-WHILE,  VOLATILITY,  etc.) 

can  apply  to  only  one  type  of  name  (CONDITION,  ENTITY,  respectively). 


*  The  exact,  manner  in  which  the  file  is  specified  is  given  in 

Part  II,  Section  7.6. 


57 


P 


O 

•• 


m 

r- 

Ov 


r- 
c\ j 


> 

< 


CO 

I” 


cc 

H 


< 

> 


ce 

cu 

Q 


H 

ULI 

(P 

I 


H 

< 


cr 

LU 

co 


LU 


>■ 

H 


Q  U 

IU  *-h 

o  n: 


v- 

03 

JO 

e= 

D 

C 


<u 

0 

>s 

O 


a 

E 

a' 


c 

<o 


c 

re 


c 

<0 


p 

<0 

jC 

-P 


tn. 

v- 

D 

O 

JO 


<ln 

JO 

P 


c 

-O 

ce 


r  • 

O  A' 


*»H  a) 
P  O 


fC  2: 


H 
*H  O 
C  JO  E 


V) 

D 

O 


> 

0) 

Vh 

D 


O 

JO 

-P 


c 

Hh 


01 

01 

>s 

o 


ai 


a> 

jo 

4-> 


LU 

X 

E 

o 

t — i 

>> 

L,  t> 

P 

H 

JO 

c  c 

+~rr 

< 

<P  P 

P 

IU 

T5 

C  *D 

c 

o 

<L 

•H  Q1 

01 

> 

u 

G 

r-> 

M-h 

0)  0) 

>S 

O 

T-f 

JO  L, 

(n 

P 

4->  a 

a 

Cl 

>- 

c 

ID 

H 

0) 

in  ai 

<u 

x 

» — i 

T3 

c  j: 

JO  . 

o 

_i  no 

•H 

*P  P 

P 

2: 

l-H  o 

CO 

o 

H  X 

in 

-P  *C 

in 

CL 

<  ro 

♦rH 

C  ^ 

♦*— i 

■U  Cl 

O 

r-> 

v_> 

0) 

o  L< 

p 

>  H 

0) 

o 

D 

c  2 

>, 

4->  5 

a  • 

21  »-H 

O 

D 

-p 

cr 

*— < 

a  <p 

D  L< 

LU  CL 

a 

C  a> 

o  o 

cr 

E 

•H  >s 

3  UJ 

O' 

O 

in 

••-h  in 
jo  ^ 

P  0) 


<D 


! 


ii 

l! 


co 

ir\ 


r- 

N*>  0  — 

1—4 

♦“ H  4-) 

<D 

t — * 

0) 

j 

o 

cr  l 

t-4 

t-4 

5: 

Cl  LU 

Q- 

CL 

CL 

r- 

C  LO 

»— < 

►— * 

i — i 

00  X 

cr 

cr 

rc 

t  k 

^0 

< 

o 

o 

i 

t 

2  LL. 

CO 

(O 

-P  CO 

V 

i — i 

a 

#->  ' - s 

v-< 

LU 

LU 

C  UJ 

i 

CO 

Cl 

• — *  0.0 

a 

a 

O'  a 

; 

^*Hl 

f— < 

c 

LU 

i» 

Cl  tU 

“O 

<31 

> 

a: 

•  i-l 

0 

L< 

J~> 

<c 

r~* 

w 

CL  ►-« 

O' 

IT 

fU 

) 

LL 

o  ro 

_ 

U  — 

C\J 

•)  _ 

CNJ 

co  •*: 

6 

1 

CO 

L1 1  1 

< — 1 

<L' 

r>- 

C  LU 

c 

(- 

LU 

D 

f“ 

'rH 

r' 

H 

lu  m 

0^ 

o 

u 

*— J  [-H 

•— »  c 

< 

LU  LO 

PUNCHED  COMMENT  ENTRIES 


m 

o 


r^ 

f\i 

>■ 

< 


o 

r*^ 

o 

r- 


to 


LU 

> 


J-H 

H 

< 

> 

►—< 

cr 

tu 

Q 

in 

4-3 

o 

H 

0) 

UJ 

CO 

a' 

1 

U, 

>~ 

c 

H 

o 

*o 

*-H 

c 

• 

4-3  • 

c: 

»— 1 

4 -> 

fC  4-3 

H 

u, 

E  U. 

c 

< 

c 

Sh  o 

o 

CL 

o  o 

•rH 

c 

(1) 

H-h  o 

4-3 

c 

O 

> 

U, 

c  u, 

CD 

c 

•*H 

<— w 

V-> 

*rH 

E 

•r4 

-P 

4-> 

4-3 

u, 

4-3 

c 

1 

O'  X 

c 

r 

cr 

xz 

05 

H-. 

E 

Jh 

UJ 

>.  c 

c 

U. 

o 

CO 

Q' 

o  X 

•< — 1 

c 

H-t 

xz 

«-H  4-3 

M-H 

c 

UJ 

4-) 

o 

4-> 

c  m 

•rH 

E  v- 

T3 

r 

o 

<D  O 

a 

r-H 

s-« 

>- 

4-> 

c 

0>  05 

05  O 

H 

£  c 

•r4 

CD  *rH 

in 

* — < 

c 

a)  o 

>>  H-* 

CD  4-> 

o 

C  *H 

4-3 

o 

X)  *<"4 

*— i 

*H 

4-3 

o 

-H  a 

c 

H 

4-3 

Hh  o 

CD 

o  x: 

re  r 

< 

CD 

O  a) 

u, 

E  4-3 

4-> 

O 

E 

in 

Jh 

O' 

re  C5 

v-r 

U, 

o 

*U  V-i 

> 

0 

*H  C5 

L> 

3^  C  4-3 

•  *H 

v-^ 

Sh 

C  L, 

CL'  O 

G5  -p 

-d* 

C 

D 

in  • 

c  in  x 

x:  c 

•rH 

X 

4->  a- 

o  V-, 

4-3  e 

>■ 

V 

a  in 

H-.  C'  Lh 

H  X  * 

in 

•rH  £ 

0>  *H 

o  c  c 

C  4-3 

^  O 

TJ 

• — <  Q.' 

o  *2 

n  a 

^3  O 

u  x 

T) 

o  c 

o  u, 

4-3  Vh 

05 

M  O 

<C 

> 

c  © 

— t  in  "O  **~5 

H  O. 

05 

x 

c  0)  V 

‘O  05 

< 

in 

a?  x 

in  4-> 

D  XZ  — * 

CZ  U 

U  H 

in 

4-3 

in  o 

4-3  05 

c  2; 

CD 

4-3 

a' 

CD  tH 

•  •  •• 

>  — « 

O 

a  4-3 

O  4-3 

C  CD 

c  cr 

o 

05  C 

C  3 

*0  o 

a)  in 

2:  cl 

u. 

o  -4 

v<  a 

fO  CD  •• 

X  ■ — 1 

o 

o  u, 

a  c 

&  XZ  M-i 

4-3  C: 

UJ  UJ 

Q  C 

•r4 

L  U*H 

cr  u 

••*  in 

m 

o  •— « 

O  X  *H 

o 

13*.  ’H  Q’. 

r-X  /■->, 

a  x 

C  C  X 

C  —  1  1 

err 

•-III 

LU  31 

•rH  1— »  4-3 

-4  LU  —  CM 

C  M  4-3  4-3 

C  UJ  —  r\j  no 

O  1 

4-> 

4_>  *'v* 

o 

o  cr 

C  UJ 

c  x 

C  x 

•rH  X 

•-4  ro 

rr  to 

•-H  •— » 

•<— i  CO 

4-3  i— t 

4-3  CL 

cr  o 

Ui  X 

U.  LU 

co  cr 

CC  LU 

k: 

< 

o  o 

0.0 

“O  o 

*C 

w 

re.  LU 

1  CO 

1  o 

•H  CO 

*r4  CO 

o 

f — >  o 

a  uj 

a'  cc 

•-H  LU 

r-H  err 

O. 

» — ■  X 

C  X 

a»  cl 

o  o 

O  CL 

s, 

>, 

s 

•• 

CL  LU 

o' 

o 

1 

1 

-U 

» — i  . — 1 

— 1 

rH 

o 

O 

cr  > — « 

c, 

o 

Mh 

S-H 

LU 

O  X 

T~.  _ _ 

r  —  cm 

C  —  Cvi 

n 

1 

2 
3 

'C  'XI 

to  ?: 

CJ 

a) 

•< — 1 

*»-4 

CO 

mi 

1 

J 

1 

| 

fn 

— j  i-L; 

)1 

L 

m 

“3 

c 

0' 

o 

0 

<— 

m  cr 

c 

c 

c 

c 

Lu 

i  •  t 

•  CO 

< 

x  :c 

o: 

k 

.»{ 

.  •* 

— 

At 

;*0 

-*• 

»r\ 


<D 


o 


7.7  RENAME  (REN) 


Modification  Made 


The  RENAME  command  takes  an  old  name  (of  some  object  in  the 
problem  statement  data  base)  and  a  new  name  as  input.  If  the 
new  name  is  not  a  URL  reserved  word  or  a  name  already  in  the 
data  base,  the  command  will  replace  the  old  name  by  the  new  name. 
Before  a  name  is  changed,  URA  checks  that: 

-  the  old  name  exists  in  the  data  base 

-  the  new  name  is  not  already  used  in  the  data  base 

-  the  new  name  is  a  legal  URL  name  (see  the  "User  Requirements 
Language,  Version  3.0,  Language  Reference  Manual"*) 

If  any  of  these  requirements  are  violated,  no  change  will  be 
made. 

Output  Description 

The  output  generated  from  this  command  is  called  the  RENAME 
REPORT.  For  every  name  changed  by  the  RENAME  command,  this 
report  presents  the  "old  name"  which  appeared  in  the 
data  base  and  the  "new  name"  which  has  taken  its  place.  When 
the  name  change  is  not  successful,  error  diagnostics  are  also 
printed  specifying  the  cause  of  the  error.  Again,  the  names 
are  printed  on  the  output  in  the  same  order  as  they  are  read 
as  input. 

Execution 


To  change  one  name  in  the  data  base,  the  following  command  might 
be  given: 

RENAME  OLD=employee-code  NEW=employee-nuraber 

Upon  first  defining  the  target  system, "employee-code"  was  used  to 
represent  a  certain  piece  of  data.  Later  it  was  found  that  this 
data  was  actually  called  "employee-number" and  the  change  was  made  to 
be  consistent  with  organization  terminology.  See  Figure  16 
for  the  report  generated  by  this  command.  This  command  is  also 
beneficial  for  changing  misspelled  names  in  the  data  base.  Through 
typing  errors,  "employee-number"  may  have  gone  in  as  "emplyee- 
nuber".  This  mistake  can  be  corrected  by: 

RENAME  01.D=cmplyee-nuber  NEW=employee-number 


*  1SD0S  Working  Paper  No.  68. 
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Options  and  Alternatives 

1.  As  with  most  of  the  modifier  commands,  the  problem  definer 
has  the  option  of  changing  several  names  at  one  time.  The 
old-new  name  pairs  must  first  be  put  in  a  file  to  be  used 
as  input  to  the  command.  (This  is  usually  done  via  the 
INPUT  parameter.)  Figure  14  presents  the  output  resulting 
from  this  procedure,  bach  line  of  the  file  must  consist  of 
an  old  name  followed  by  the  corresponding  new  name.  The  two 
names  may  be  anywhere  in  the  first  80  columns  of  the  line  and 
must  be  separated  by  one  or  more  blanks.  The  format  of  the 
file  used  to  produce  Figure  17  is  given  below: 


henry-miller 

changing-employee-data 


joseph-i-smith 
varying- employee -data 


level-1 

error-listing 


11 

error-list 


Common  Errors 

The  most  common  error  in  using  RENAME  is  specifying  a  name  already 
in  the  data  base  or  a  URL  reserved  word  as  the  new  name.  URA  will 
not  make  the  change  if  this  is  the  case.  The  command  would  have 
to  be  reissued  with  another  new  name  to  take  the  place  of  the 
illegal  one. 

If  neither  an  input  file  or  an  OLD/NEW  pair  of  parameters  is 
specified  for  the  command,  the  message:  "MUST  GIVE  OLD  AND  NEW, 

OR  INPUT"  will  be  printed  by  URA  .  Should  this  happen,  URA  will 
not  execute  the  RENAME  command.  The  command  and  its  parameters 
should  be  reentered  with  the  necessary  corrections. 
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Figure  17 


7.8  REP LACE -COMMENT- ENTRY  (RCOM) 


Modification  Made 


This  command  takes  as  input  names  which  exist  in  the  data  base, 
each  followed  by  a  URL  comment  entry  statement.  If  the  comment 
is  a  DESCRIPTION  comment  entry,  for  example,  then  the  command 
will  replace  the  old  DESCRIPTION'  comment  entry  by  the  one  used 
as  input.  What  RCOM  actually  does  is  delete  the  old  comment 
entry  and  put  the  new  comment  entry  in  its  place.  This  is  done 
after  a  check  has  been  made  to  ascertain  that  the  "old  comment 
entry"  exists  in  the  data  base  and  the  "new  comment  entry"  is 
legal  for  the  particular  application  being  used  (e.g.,  not  attempting 
to  enter  a  PROCEDURE  comment  entry  for  a  SET  name).  A  check  is  made 
to  see  if  the  input  name  is  in  the  data  base. 

If  an  attempt  is  made  to  replace  a  comment  entry  for  a  name  that 
did  not  have  a  comment  entry  specified  for  it,  the  message: 

URA  126:REPSET:  WARNING  -  THERE  IS  NO  COMMENT  ENTRY  TO  DELETE 

will  be  given  and  the  designated  comment  entry  will  be  connected 
to  the  name. 

Output  Description 

The  output  generated  by  this  report  is  called  REPLACED  COMMENT 
ENTRIES.  For  each  "old  comment  entry"  to  be  replaced,  the  output 
depicts,  in  the  following  order: 

-  name  to  which  the  "old  comment  entry"  belongs 

-  the  type  of  comment  entry  which  is  being  changed 

-  the  entire  text  of  the  "old  comment  entry" 

-  the  entire  text  of  the  "new  comment  entry"  which  replaces  the  old  one 

Error  diagnostics  referring  to  problems  encountered  in  executing 
the  command  are  also  printed  here. 

Execution 

Any  information  to  be  supplied  as  input  to  RCOM  must  first  be 
placed  in  a  file  and  the  file  must  be  designated  as  input.*  (This 
is  usually  done  via  the  INPUT  parameter.) 


*  The  exact  manner  in  which 

Part  II,  Section  7.8. 


the  file  is  specified  is  given  in 
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The  contents  of  the  file  must  be  in  the  following  format: 
name 

comment  entry  type; 


comment  entry 


etc. 


The  contents  of  the  file  used  to  produce  the  output  shown  in 
figure  18  was: 

new-employee-printing 

DESC; 

This  process  produces  the  new  hire  section  of  theh-t  report; 
new-employee-printing 
PRCD; 

1- )  accept  a  valid  unit  of  new  employee  information 

2- )  save  the  information 

3- )  print  the  new  hire  section  of  the  h-t  report; 


Options  and  Alternatives 


1.  It  is  often  the  case  that  only  some  minor  editing  of  a  comment 
entry  need  be  done  to  make  it  correct.  This  can  be  done  when 
the  output  from  the  PUNCH-COMMENT-ENTRY  command  is  edited  and 
used  as  input  to  the  RCOM  command.  This  is  described  in 
Section  7.6  of  this  paper. 

2.  To  suppress  printing  of  the  REPLACED  COMMENT  ENTRIES  report  the 
NOPRINT  parameter  may  be  specified. 


Common  Errors 


The  major  problem  in  using  this  command  is  specifying  the  file  format 
correctly.  (This  is  not  a  problem,  however,  if  the  contents  of  the 
file  used  was  produced  by  PUNCH -COMMENT- ENTRY.)  Although  the  command 
allows  free  formatting  of  the  file,  the  order:  name,  comment-entry 
type,  comment-entry  must  be  maintained.  Each  must  begin  on  a  new 
line. 
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g.  REPORT  COMMANDS 


Report  Commands  retrieve  specific  types  of  information  from  the 
data  base  and  present  it  in  formats  which  aid  the  problem  definer 
to  analyze  the  problem  statement  for  correctness  and  completeness. 
Many  of  the  formats  can  serve  as  final  specifications 
of  the  system  being  designed. 

Most  report  commands  allow  the  report  to  be  generated  for  a  single 
name  (via  the  NAME  parameter)  or  for  a  number  of  names  placed  in  a 
file  and  specified  as  input  to  the  command.* 

% 

The  descriptions  of  these  report  commands,  their  usage  and  interpre¬ 
tation,  and  the  usage  of  reports  produced  by  them  are  given  in  '\JRA 
*  Outputs."** 


*  The  exact  manner  in  which  this  is  done  is  installation  dependent 
and  is  given  in  Part  H,  Section  8. 

**  Part  III. 
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9.  ERROR  DIAGNOSTICS 


URA  has  extensive  checking  facilities  to  prevent  errors  in  the 
problem  statement.  At  the  URAcommand  mode  level,  checks  are  made 
to  insure  that  all  commands  given  are  legal  URA  commands  and  that  all 
parameters  given  are  legal  parameters  for  that  command.  If  an 
illegal  command,  an  illegal  parameter,  or  illegal  parameter  for 
that  command  is  given  when  in  on-line  mode,  the  following  message 
will  be  generated: 

INVALID  PARAMETER  -  < 

ENTER  REPLACEMENT  OR  BLANK  LINE 
? 

The  user  must  enter  the  replacement  following  the  question  mark 
and  then  hit  the  carriage  return  key.  If  the  command  is  accepted, 
processing  of  that  command  commences.  Should  an  error  be  encountered 
while  processing  the  command,  one  of  the  following  three  types  of 
error  diagnostics  will  be  given: 

i)  Data  Base  Management  System  Errors 

These  errors  are  encountered  when  there  may  be  some  danger 
of  destroying  the  contents  of  the  URA  data  base  or  there  is 
an  error  in  the  URA  software.  Even  though  the  URA  software 
might  be  the  cause  of  the  error,  it  is  doubtful  if  it  will 
do  anything  to  harm  the  contents  of  the  user's  data  base.  A 
complete  list  of  these  error  messages  is  given  in  "A  Data 
Base  Management  System  for  URA  Based  on  DBTG  71 •"  * 

***  ERROR  16  -  DATA  BASE  FILE  INCONSISTENT 

This  error  message  is  given  if  the  user  attempts  to 
modify  or  retrieve  information  from  a  URA  data  base 
which  has  had  its  contents  altered  so  that  it  is  unusable 
by  the  URA  software. 

****  ERROR  ft  n  FOUND  IN  ROUTINE  »  m 

An  error  message  of  this  format  usually  designates  an  error 
in  the  URA  software,  where  n  is  the  error  number.  To  find 
out  which  routine  the  error  occurred  in,  refer  to  "A  Data 
Base  Management  System  for  URA  Based  on  DBTG  71."*  If  the 
values  of  the  variables  n  and  m  are  16  and  30  respectively, 
the  error  designates  a  data  base  inconsistency  which  is 
usually  a  user  error.  Any  other  errors  of  this  form  with 
different  values  should  be  brought  to  the  attention  of 

those  persons  maintaining  the  URA  software.  k 

ii)  URA  Command  Errors 

These  errors  are  encounted  in  the  processing  of  URA  commands  * 

and  are  user  errors.  These  diagnostics  are  generated  when 

the  user  presents  ambiguous  or  incorrect  information  to  the 

URA  commands .  In  most  cases,  URA  will  take  no  action  to 

fulfill  the  user's  request  if  an  error  is  encountered.  The 

command  must  be  restated  in  corrected  form,  before  action  is 

taken.  All  these  errors  are  presented  in  the  following  format: 
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*  ..  .  . 


*  1SDOS  Working  Paper  No. 


88,  "A  Data  Base  Management  System 


URAnnn: subroutine:  error-message 

where  "nnn"  designates  the  URA  error  number,  "subroutine" 
denotes  the  subroutine  in  the  URA  software  where  the  error 
occurred,  and  "error-message"  corresponds  to  some  diagnostics 
which  describe  the  error  condition. 

iii)  URA  Input  Errors 

These  errors  are  encountered  when  the  INPUT-PSL  or  DELETE- 
PSL  are  used  incorrectly.  URA  always  attempts  to  recover 
from  these  errors  unless  an  excessive  number  or  errors 
have  been  encounter*.  .  Each  of  these  errors  is  assigned 
a  level  number,  1  though  4.  The  user  is  allowed  to  make  up 
to  24  level  1  and  24  level  2  errors,  but  a  single  level  3  or 
level  4  error  will  terminate  processing  of  the  command.  The 


levels  are  described  below. 

Level  Description  Limit 

1  Warning  24 

2  Serious  user  error  24 

3  URA  unable  to  recover  0 

4  Exceeded  URA  capabilities  0 


These  types  of  errors  are  presented  in  the  following  format: 

****  LEVEL  j,  URfrinn: subroutine:  error-message 

where  "j"  designates  the  level  number  and  "nnn"  denotes 
the  URA  error  number.  The  last  part  of  the  format  is  the 
same  as  the  URA  command  errors . 

After  processing  any  URA  command,  a  STOP  status  message 
is  given.  This  message  designates  that  processing  of  the 
command  was  successful  (STOP  0,  i.e.,  errors  were  handled 
effectively,  etc.)  or  that  processing  was  not  totally 
successful  (STOP  4  or  STOP  8).  STOP  4  is  given  when  an 
error  level  limit  is  exceeded  for  INPUT-PSL  errors,  for 
example.  The  STOP  8  message  designates  a  serious  error 
in  attempting  to  access  the  data  base,  usually  resulting 
from  an  inconsistent  data  base. 

The  following  is  a  list  of  all  possible  errors  that  can  be 
encountered  while  using  URA  .  A  short  description  of  each 
error  accompanies  it  as  well  as  suggested  action  to  take 
should  the  error  occur. 
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Number  Subroutine  Error  Message 


2  NLEX: 

NAME  TOO  LONG 

A  user  defined  name  has  exceeded  the  30  character  limit 
allowed  by  URL/URA.  The  name  is  truncated  to  30,  but 

Is  still  put  in  the  data  base.  (See  Section  10.1, 
part  v.) 

3  NLEX: 

'EOF'  NOT  FOUND  BEFORE  END-OF-FILE 

The  user  has  terminated  the  input  before  specifying 
the  URL  'EOF.'  Processing  of  the  input  is  terminated. 

4  NLEX: 

ILLEGAL  CHARACTER  -  TREATED  AS  BLANK 

Either  an  illegal  character  encountered  in  an  input  line 
or  legal  url  character  used  in  the  wrong  context.  See 
the  ".User  Requirements  Language,  Version  3.0,  Language 
Reference  Manual"*  for  a  list  of  legal  characters.  The 
illegal  character  is  replaced  by  a  blank  and  processing 
of  the  url  statement  continues. 

5  NLEX: 

END-OF-FILE  IN  MIDDLE  OF  COMMENT 

The  end  of  input  has  been  encountered  following  the  '/*' 
comment  characters.  Processing  of  the  input  is  terminated. 

6  SCAN: 

INVALID  LEXICAL  TYPE  RETURNED  FROM  NLEX 

ura  sofware  error.  Please  notify  persons  maintaining 

URA  should  this  error  occur. 

7  .  SCAN: 

ILLEGAL  CHARACTER  -  IGNORED 

An  illegal  character  encountered  when  scanning  an  input 
line.  See  the  "User  Requirements  Language,  Version  3.0 
Language  Reference  Manual"*  for  a  complete  list  of 
legal  characters.  The  illegal  character  is  ignored  and 
processing  of  the  url  statement  continues. 

8  COMLOP: 

PARSE  STACK  OVERFLOW 

URA  software  error.  Please  notify  persons  maintaining 
ura  should  this  error  occur. 

9  PROK: 

BAD  CASE 

URA  software  error.  Please  notify  persons  maintaining 

URA  should  this  error  occur. 

10  REDUCE: 

NO  APPLICABLE  PRODUCTION  -  SYNTAX  ERROR  -  START  SKIPPING 
Illegal  URL  statement  syntax  is  encountered.  If  this 
is  a  header  statement,  following  statements  will  be 
assigned  to  the  previous  header  statement.  The  error  may 
be  a  result  of  incorrect  usage  of  a  url  reserved  word. 

(See  SectionlO.l,  part  i.) 

11  STACK 

ILLEGAL  SYMBOL  PAIR  -  SYNTAX  ERROR  -  START  SKIPPING 

Illegal  url  statement  syntax  is  encountered.  If  this 
is  a  header  statement,  follov/ing  statements  will  be 
assigned  to  the  previous  header  statement.  This  state¬ 
ment  is  not  entered  into  the  ura  data  base.  (See  Section 
10.1 ,  part  i . ) 

Nuiriber  Subroutine  Error  Message 


12 

SYMBOL: 

SYMBOL  TABLE  OVERFLOW 

Exceeded  limits  of  ura.  Reissue  INPUT-PSL  command  at 
point  in  the  input  file  wfiere  this  error  occurred, 

13 

* 

SYMBOL: 

TOO  MANY  SYMBOLS 

Exceeded  limits  of  ura.  Reissue  INPUT.-PSL  command  at 
point  in  the  input  file  where  this  error  occurred. 

14 

SETYPE: 

INVALID  SYMBOL  TABLE  POINTER 

ura  software  error.  Please  notify  persons  maintain¬ 
ing  ura  should  this  error  occur. 

15 

STACK: 

INVALID  CASE 

ura  software  error.  Please  notify  persons  maintaining 
ura  should  this  error  occur. 

16 

COMENT: 

END-OF-FILE  IN  COMMENT  ENTRY 

End  of  input  encountered  in  URL  comment 
entry.  Processing  of  the  input  is  terminated. 

17 

SKIP: 

END  OF  FILE  WHILE  SKIPPING 

Serious  error.  In  attempt  to  recover  from  previous 
errors  the  end  of  input  has  been  encountered.  Process¬ 
ing  of  input  is  terminated. 

W  18 

I  DENT: 

NO  NAMES  IN  DATA  BASE 

Attempt  to  retrieve  names  from  an  empty  data  base. 

19 

RECOV: 

UNABLE  TO  RECOVER  AT  THIS  TIME 

Processing  of  input  is  terminated  due  to  serious  errors 
which  make  it  unable  to  continue. 

20 

RECOV: 

LAST  STATEMENT  SKIPPED 

Statement  where  error  occurred  is  skipped  so  that  process¬ 
ing  of  input  may  continue. 

21 

SETINF: 

INVALID  SYMBOL  TABLE  POINTER 

ura  software  error.  Please  notify  persons  maintaining 
ura  should  this  error  occur. 

22 

OTHERS: 

SAME  ATTRIBUTE  ALREADY  GIVEN  WITH  DIFFERENT  ATTRIBUTE  VALUE 
An  attempt  v/as  made  to  assign  a  second  value  to  the  same 
ATTRIBUTE  for  a  given  name.  The  new  value  is  ignored. 

23 

* 

SUBPRT: 

TOO  MANY  LEVELS  -  STACK  OVERFLOW 

The  limit  allowed  for  retrieving  names  via  the  SU3PARTS- 
OF  parameter  has  been  exceeded.  Reissue  the  NAME-GEN 
command  with  the  last  name  retrieved  as  the  value  for 
the  SU3PARTS-0F  parameter. 
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Error  Message 


24  MAINRCOM: 

25  HEAD: 

26  IGINFO: 

27  PTABIN: 

28  PTABIN: 

29  CHKREL : 

30  CHKREL: 

31  MAINCT: 

32  MAINCT: 

33  MAINCT: 

34  MAINCT: 

35  MAINCT: 

36  MAINCT: 


MISSING  SEMICOLON  ON  LINE  AFTER  NAME 

Semicolon  is  needed  to  terminate  comment  entry  statement. 

INVALID  HEADER  STATEMENT  -  STATEMENTS  WILL  BE  IGNORED 
Illegal  syntax  of  header  statement.  All  url  statements 
up  to  the  next  header  statement  will  be  ignored.  (This 
error  is  also  described  in  section  10.1,  part  iii.) 


INVALID  SYMBOL  TABLE  POINTER 

URA  software  error.  Please  notify  persons  maintaining 
ura  should  this  error  occur. 

INVALID  LEXICAL  TYPE  OR  END-OF-FILE 

ura  software  error.  Please  notify  persons  maintaining 

ura  should  this  error  occur. 

DUPLICATE  RESERVED  WORD  -  IGNORED 

ura  software  error.  Please  notify  persons  maintaining 
URA  should  this  error  occur. 

CONFLICT  WITH  EXISTING  CONNECTIONS  (RELA)  RELTYP  # 

Attempt  made  to  change  name  type  to  one  which  conflicts 
with  the  context  in  which  the  name  is  used.  No  change 
is  made. 

CONFLICT  WITH  EXISTING  CONNECTIONS  (RELB)  RELTYP  # 

Attempt  made  to  change  name  type  to  one  which  conflicts 
with  the  context  in  which  the  name  is  used.  No  change 
is  made. 

BAD  INPUT  FORMAT 

The  format  of  the  file  used  as  input  to  the  command  is 
incorrect.  See  the  command  description  for  correct 
format.  No  change  is  made. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  change  name  type  of  name  not  defined  in  the 
ura  data  base. 

INVALID  NAME  TYPE 

Attempt  to  assign  an  illegal  name  type  to  a  name. 

Probably  a  spelling  error. 

NAME  TYPE  TOO  LONG 

Attempt  to  assign  an  illegal  name  type  to  a  name. 

Probably  a  spelling  error. 

WARNING  -  STUFF  AFTER  NAME  TYPE 

The  input  file  contains  more  than  just  name  and  new  name  type 
The  extra  data  will  be  ignored  by  the  command  processor. 

INVALID  NAME  -  TOO  LONG 

The  name  for  which  the  change  is  to  be  made  is  over  30 
characters.  Check  spelling. 


Number  Subroutine  Error  Message 


37  FNDPD: 

38  MAINREN: 

39  MAINREN: 

40  CL REN: 

41  MAINDEL: 

42  MAINDEL: 

43  OTHERS: 

44  OTHERS : 

45  CLCT : 

46  CT: 

47  MAINNG: 

48  MAINNG: 

49  MAINNG: 


THIS  IS  NOT  A  PD  FOR  ANY  NAMES  - 

This  problem  definer  is  not  associated  to  any  names 

defined  |n  the  d^ta  b^se. 

OLD  NAME  NOT  IN  D.B, 

Attempt  to  change  name  of  some  object  which  is  not 
defined  in  the  data  base.  Probably  a  spelling  error. 

NEW  NAME  ALREADY  IN  D.B. 

Attempt  to  change  old  name  to  a  name  already  defined 
in  the  data  base.  User  must  choose  another  name. 

MUST  GIVE  OLD  AND  NEW,  OR  INPUT 
Parameters  given  for  the  command  do  not  supply  suf¬ 
ficient  Information  for  processing.  Reissue  command. 

NAME  TO  BE  DELETED  NOT  IN  D.B. 

Attempt  to  delete  a  name  which  is  not  defined  in  the 
ura  data  base. 

INVALID  MEMBER  TYPE 

ura  software  error.  Please  notify  persons  maintain¬ 
ing  URA  should  this  error  occur. 

CARDINALITY  ALREADY  GIVEN  AS  SYSPAR 
Attempt  to  assign  a  numerical  value  to  a  CARDINALITY 
statement  when  previously  assigned  a  SYSTEM-PARAMETER 
name.  The  value  is  ignored. 

CARDINALTIY  ALREADY  GIVEN  AS  DIFFERENT  VALUE 
Attempt  to  assign  a  second  value  to  a  CARDINALITY 
statement.  The  new  value  is  ignored. 

NO  TYPE  GIVEN  WITH  "NAME="  OR  "FILE"  PARAMETER 
No  new  name  type  has  been  specified.  The  command 
must  be  reissued. 

NO  NAME  GIVEN 

No  name  has  been  specified  to  have  its  name  type  changed. 
The  NAME  or  FILE  parameter  must  be  given. 

PD  NOT  FOUND  IN  DATA  BASE 

The  problem  definer  specified  by  the  PD  parameter  is 
not  defined  in  the  data  base.  No  names  will  be  generated. 

KEYWORD  NOT  FOUND  IN  DATA  BASE  - 

The  keyword  specified  by  the  KEYWORD  parameter  is  not 
defined  in  the  data  base.  No  names  will  be  generated. 

NO  NAMES  IN  DATA  BASE 

Attempt  to  retrieve  names  from  an  empty  data  base. 
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'  50  PLIST: 

51  RWLIST: 

52  IDENTC: 

5>  OPTRW : 

54  OPTRW: 

55  OPTRW: 

56  USEDTO: 

57  USEDTO: 

58  OPTRW: 

59  MAINNG: 

60  APPLES: 

61  RWLIST: 

62  RWLIST: 


TOO  MANY  NAMES  -  REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names  should  be 

gtyen  in  another  statement, 

MUST  BE  SUBSETTING  CRITERION  NAME 

Attempt  to  define  a  name  which  is  not  a  GROUP  or 

ELEMENT  to  be  SUBSETTING  CRITERION. 

NAME  NOT  IN  D.B.  - 

Attempt  to  retrieve  information  about  a  name  which  is 
not  defined  in  the  data  base. 

NAME  LIST  TOO  LONG  -  REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names  should  be 

given  in  another  statement. 

NAME  LIST  TOO  LONG  -  REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names  should  be 

given  in  another  statement. 

NAME  LIST  TOO  LONG  -  REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names  should  be 

given  in  another  statement. 

TOO  MANY  NAMES  -  REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names  should  be  given 
in  another  statement. 

TOO  MANY  NAMES  -  REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names  should  be 
given  in  another  statement. 

NAME  LIST  TOO  LONG  -  REST  IGNORED 

Exceeded  50  name  limit.  Remaining  names  should  be 

given  in  another  statement. 

SUBPARTS-OF  NAME  NOT  IN  DATA  BASE  - 

Attempt  to  retrieve  names  that  are  a  part  of  a  name 

not  defined  in  the  data  base. 

SECOND  MAILBOX  FOR  PD  ILLEGAL 

Attempt  to  associate  a  second  MAILBOX  to  a  particular 
PROBLEM  DEFINER. 

ALREADY  PART  OF  SOMETHING  ELSE 

Attempt  to  define  a  structure  where  an  object  is  PART 
OF  more  than  one  other  object.  This  is  contrary  to 

the  rules  specified  in  the  'user  Reauirements  Language, 
Version  3.0,  Language  Reference  Manual."* 

SECOND  PD  FOR  THIS  ITEM  ILLEGAL 

Attempt  to  assign  a  second  RESPOMSIBl  E -PROBLEM- DEFINER 
to  an  object.  This  statement  is  ignored. 


*  1SD0S  Working  Paper  No.  68 
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63  RWLIST : 

64  MAINDICT: 

65  MAINCONT: 

66  MAINPIC: 

67  MAINPIC: 

68  REPSET: 

69  REPSET: 

70  CLDCOM: 

76  MAINPRIO: 

87  CLDEL: 

88  MAINPRIO: 

89  MAINNG: 


ALREADY  PART  OF  SOMETHING  ELSE 
Attempt  to  define  a  structure  where  an  object  is 
•PART  OF  more  than  one  other  object.  This  is  contrary 
to  rules  specified  in  the  "user  Requirements  Language, 

Version  3.0,  Language  Reference  Manual."* 

NAME  NOT  FOUND  IN  D.B.  - 

Attempt  to  retrieve  information  about  a  name  that  is 
not  defined  in  the  data  base. 

NAME  NOT  FOUND  IN  D.B. 

Attempt  to  retrieve  information  about  a  name  that  is  not 
defined  in  the  data  base. 

NAME  NOT  IN  D.B.  - 

Attempt  to  retrieve  information  about  a  name  that  is  not 
defined  in  the  data  base. 

PICTURE  NOT  AVAILABLE  FOR  - 

Attempt  to  generate  the  report  for  a  name  which  is  not 
a  SET,  INPUT,  OUTPUT,  ENTITY,  GROUP,  ELEMENT,  PROCESS 
or  INTERFACE.  Only  these  types  of  objects  may  have 
PICTURES  generated  for  them. 

WARNING  -  MISSING  SEMICOLON.  NEW  COMMENT  ENTRY  ADDED 
Semicolon  not  given  to  terminate  comment  entry.  One 
is  assumed  and  processing  continues. 

NO  NEW  COMMENT  ENTRY  -  OLD  ENTRY  HAS  BEEN  DELETED 
Since  no  new  comment  entry  has  been  given  to  replace 
the  old,  the  old  comment  entry  statement  is  deleted. 

NO  NAME  OR  FILE  SPECIFIED 

Either  the  NAME  or  FILE  parameter  must  be  given  for 
this  command  to  be  executed.  Parameters  given  do 
not  supply  sufficient  information  for  processing. 

Reissue  command. 

NAME  NOT  IN  DATA  BASE  - 

Attempt  to  retrieve  information  about  a  name  that  is 
not  defined  in  the  data  base. 

NO  NAME  OR  FILE  WAS  SPECIFIED 

Either  the  NAME  or  FILE  parameter  must  be  given  for 

this  command  to  be  executed.  Parameters  given  do  not 

supply  sufficient  information  for  processing.  Reissue  command 

NAME  NOT  A  PROCESS  NAME  - 

Attempt  to  retrieve  information  from  a  name  that  is  not 
a  PROCESS  name.  Only  PROCESS  names  may  be  used  as  input 
to  this  conmand. 

NAME  MUST  BE  INPUT,  OUTPUT,  PROCESS,  OR  INTERFACE  FOR  "SO" 
PARAMETER  - 

Attempt  to  retrieve  SUBPARTS  information  for  a  name  which 
is  not  an  OUTPUT,  INPUT,  PROCESS  or  INTERFACE.  Only  these 
objects  may  have  "SUBPARTS." 
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90  RWLIST:  SSCN  IS  ONLY  LEGAL  TYPE  IN  DEFINE  SECTION  WHICH  CAN 

BE  MAINTAINED 

Attempt  to  use  MAINTAINED  statement  for  some  object 
Whfch  is  not  SUBSETTING-CRITERION, 


91  ADDUSE;  TOO  MANY  USAGES 

ura  software  error.  Please  notify  persons  maintain¬ 
ing  ura should  this  error  occur. 


92  MAINPAV:  NAME  NOT  IN  D.B.  -  .  .  ,  . 

Attempt  to  retrieve  information  about  name  winch  is 
*  not  defined  in  the  data  base. 

93  MAINPAV:  NAME  HAS  NO  USAGES  AS  ATTRIBUTE  FOR  ANYTHING  - 

Attempt  to  retrieve  ATTRIBUTE  information  for  a  name 
which  is  not  an  ATTRIBUTE. 


95  CLEI: 


98  CONCOL: 

99  IDENTR: 


MUST  GIVE  EITHER  ENTITY  OR  IDENTIFIER  PARAMETER 
Either  the  ENTITY  or  IDENTIFIER  parameter  must  be 
used  in  conjunction  with  this  command  for  successful 
implementation. 

NAME  NOT  IN  D.B.  - 

Attempt  to  retrieve  information  about  a  name  not 
defined  in  the  data  base. 

NAME  NOT  IN  D.B.  - 

Attempt  to  retrieve  information  about  a  name  not  defined 
in  the  data  base. 


100  ATLIST: 

101  ATLIST: 

102  ATLIST: 


TOO  MANY  ATTRIBUTE  VALUE  PAIRS  IN  SINGLE  STATEMENT 
Limit  exceeded.  Remaining  pairs  should  be  given  in 
another  statement. 

NAME  MUST  BE  ATTRIBUTE  NAME 

Attempt  to  use  a  name  defined  as  something  else  as  an 
ATTRIBUTE  name. 

NAME  MUST  BE  ATTRIBUTE  VALUE  NAME 

Attempt  to  use  a  name  defined  as  something  else  as  an 

ATTRIBUTE-VALUE  name. 
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103 

DELSET; 

DESCRIPTION  COMMENT  ENTRY  NOT  FOUND  FOR  ; 

Attempt  to  delete  a  nonexistent  DESCRIPTION  statement. 

104 

DELSET: 

PROCEDURE  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  delete  a  nonexistent  PROCEDURE  statement. 

105 

DELSET: 

VOLATILITY  COMMENT  NOT  FOUND  FOR  : 

Attempt  to  delete  a  nonexistent  VOLATILITY  statement. 

106 

DELSET: 

VOLATILITY-MEMBER  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  delete  a  nonexistent  VOLATILITY-MEMBER 
statement. 

107 

DELSET: 

VOLATILITY-SET  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  delete  a  nonexistent  VOLATILITY-SET  statement. 

108 

DELSET: 

DERIVATION  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  delete  a  nonexistent  DERIVATION  statement. 

109 

DELSET: 

TRUE  WHILE  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  delete  a  nonexistent  TRUE  WHILE  statement. 

no 

DELSET: 

FALSE  WHILE  COMMENT  NOT  FOUND  FOR  : 

Attempt  to  delete  a  nonexistent  FALSE  WHILE  statement. 

in 

MAINDCOM: 

NAME  NOT  FOUND  IN  D.B .  : 

Attempt  to  delete  information  for  a  name  not  defined 

In  the  data  base. 

113 

CLCM: 

MUST  GIVE  EITHER  CONSISTS  OR  CONTAINED  PARAMETER 

Either  the  CONSISTS  or  CONTAINED  parameter  must  be 
used  in  conjunction  v/ith  this  command. 

114 

VLIST: 

ONLY  SINGLE  VALUE  OR  RANGE  ALLOWED  -  IGNORED 

Invalid  format  for  specifying  a  VALUES  statement.  See  the 

"User  Requirements  Language,  Version  3.0,  Language  Reference  Manual. 

115 

VLIST : 

MIN  NOT  LESS  THAN  MAX  -  IGNORED 

If  a  number  range  is  specified  the  first  number  must 
be  less  than  the  second  number. 

116 

OTHERS 

VALUES  ONLY  LEGAL  FOR  ELEMENT,  SYSPAR,  OR  ATTRIBUTE- 
VALUE 

Attempt  to  use  a  VALUES  statement  for  a  name  v/hich  is 
not  an  ELEMENT,  SYSTEM-PARAMETER  or  ATTRIBUTE-VALUE. 

117 

OTHERS : 

DIFFERENT  VALUES  ALREADY  GIVEN 

Attempt  to  assign  a  second  value  for  a  given  object. 

This  statement  is  .ignored. 
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-  118 

SYSNL; 

INVALID  SYSPAR  GIVEN 

Error  encountered  in  using  a  SYSTEM-PARAMETER  \n  a  given 
statement,  Interpretation  of  rest  of  statement  becomes 
confused. 

119 

SYSNL: 

SYSPAR  MUST  BE  GREATER  THAN  ZERO 

Attempt  to  use  zero  as  a  SYSTEM-PARAMETER. 

120 

SNAMET: 

NAME  ALREADY  USED  IN  DIFFERENT  CONTEXT 

Attempt  to  use  a  name  in  a  context  which  conflicts  in 
the  way  It  has  previously  been  used. 

121, 

MAINRCOM: 

NAME  NOT  FOUND  IN  DATA  BASE  - 

Attempt  to  access  information  for  a  name  not  defined 
tn  the  data  base. 

122 

MAINRCOM: 

INVALID  TYPE  OF  COMMENT  ENTRY  - 

Attempt  to  replace  unrecognizable  comment  entry  statement. 
Probably  a  spelling  error. 

123 

MAINRCOM: 

CANNOT  HAVE  THIS  TYPE  OF  COMMENT  ENTRY  - 

Attempt  to  assign  a  comment  entry  statement  which  is 

not  legal  for  the  particular  name  type. 

124 

REPSET: 

...WITH  THIS  NAME  - 

Used  in  conjunction  with  ura123.  Specifies  the  name 
for  which  the  comment  entry  was  used. 

125 

MAINRCOM: 

PROBLEMS  SCANNING  INPUT  FILE  -  MUST  ABORT 

Incorrect  format  of  file  used  for  input.  See  command 
description  for  correct  format. 

126 

REPSET: 

WARNING  -  THERE  IS  NO  COMMENT  ENTRY  TO  DELETE 

Attempt  to  delete  nonexistent  comment  entry. 

127 

PUNSET: 

DESCRIPTION  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  retrieve  nonexistent  DESCRIPTION  statement. 

128 

P UNSET: 

PROCEDURE  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  retrieve  nonexistent  PROCEDURE  statement. 

129 

PUNSET: 

VOLATILITY  COMMENT  NOT  FOUND  FOR  : 

Attempt  to  retrieve  nonexistent  VOLATILITY  statement. 

130 

PUNSET: 

VOLATILITY-MEMBER  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  retrieve  nonexistent  VOLATILITY -MEMBER 
statement. 

131 

PUNSET: 

VOLATILITY-SET  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  retrieve  nonexistent  VOLATILITY-SET  statement. 
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132  PUNSET; 

DERIVATION  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  retrieye  nonexistent  DERIVATION  statement. 

133  PUNSET: 

TRUE  WHILE  COMMENT  ENTRY  NOT  FOUND  FOR  : 

Attempt  to  retrieve  nonexistent  TRUE  WHILE  statement. 

134  PUNSET: 

FALSE  WHILE  COMMENT  NOT  FOUND  FOR  : 

Attempt  to  retrieve  nonexistent  FALSE  WHILE  statement. 

135  MAINPCOM: 

NAME  NOT  FOUND  IN  D.B.  : 

Attempt  to  retrieve  information  for  a  name  not  defined 
in  the  data  base. 

14r  CONROW: 

NAME  NOT  IN  D.B.  - 

Attempt  to  retrieve  information  for  a  name  not  defined 
in  the  data  base. 

142  BETWEN: 

THE  TWO  NAMES  ARE  NOT  CONNECTED  IN  THAT  FASHION 

Attempt  to  delete  a  relationship,  between  two  names, 
which  is  not  defined  in  the  data  base. 

143  MAINDP: 

NAME  NOT  IN  D.B.  - 

Attempt  to  retrieve  information  about  a  name  which 
is  not  defined  in  the  data  base. 

144  DPCOL : 

TOO  MANY  COLUMNS 

Exceeded  limits  of  the  software  that  produces  the  matrix 
Names  omitted  from  the  matrix  should  be  used  as  Input 
to  another  DP  command. 

145  DPCOL: 

TOO  MANY  ROWS 

Exceeded  limits  of  the  software  that  produces  the  matrix 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  DP  command. 

146  DPCOL: 

SPARSE  MATRIX  SYSTEM  OVERFLOW 

Exceeded  limits  of  the  software  that  produces  the  matrix 

147  SPROW: 

TOO  MANY  ROWS 

Exceeded  limits  of  the  software  that  produces  the  matrix 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  DP  command. 

148  DPROW: 

TOO  MANY  COLUMNS 

Exceeded  limits  of  the  software  that  produces  the  matrix 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  DP  command. 

149  DPROW: 

SPARSE  MATRIX  SYSTEM  OVERFLOW 

Exceeded  limits  of  the  software  that  produces  the  matrix 

Number 


Subroutine  Error  Message 


w  150 

DPSUM: 

NO  ROWS 

No  relationships  can  be  specified  about  the  nanies  used 
as*  input,  so  no  matrix  will  be  generated. 

151 

DPSUM: 

NO  COLUMNS 

No  relationships  can  be  specified  about  the  names  used 
as  input,  so  no  njatrfx  will  be  generated. 

152 

DPSUM: 

SPARSE  MATRIX  SYSTEM  OVERFLOW 

Exceeded  limits  of  the  software  that  produces  the  matrix. 

153 

«T 

MAINDP : 

INVALID  INPUT  NAME  TYPE  - 

Attempt  to  use  a  name  which  is  not  a  PROCESS  name  as 
input  to  the  command. 

154 

MAINDP: 

INVALID  INPUT  NAME  TYPE  - 

Attempt  to  use  a  name  which  is  not  a  SET,  INPUT,  OUTPUT, 
ENTITY,  GROUP  or  ELEMENT  name  as  input  to  the  command. 

155 

DPSUM: 

INVALID  ROW  TYPE  -  SYSTEM  ERROR 

ura  software  error.  Please  notify  persons  maintaining 
ura  should  this  error  occur. 

156 

CNTAND: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  has  not  been 
defined  in  the  data  base. 

157 

BETWEN: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  has  not  been  defined 
In  the  data  base. 

158 

UDDERS: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  has  not  been 
defined  in  the  data  base. 

159 

UDDERS: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  has  not  been 
defined  in  the  data  base. 

160 

UDDERS : 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  has  not  been 
defined  in  the  data  base. 

161 

UDDERS: 

NO  CONNECTIVITY  EXISTS 

Attempt  to  delete  a  relationship  which  does  not  exist 
for  this  name. 

162 

UDDERS: 

DIFFERENT  CONNECTIVITY  IN  DATA  BASE  -  NOT  DELETED 

Attempt  to  delete  a  relationship  which  is  not  stated 
exactly  as  it  is  in  the  data  base. 

■ 
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Error  Message 

163  UDDERS: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

164  UDDERS: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

165  UDDERS: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

166  UDDERS: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

167  UDDERS: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

168  UDDERS: 

DIFFERENT  VALUES  IN  DATA  BASE  -  NOT  DELETED 

Attempt  to  delete  a  number  or  range  of  numbers  that 
was  not  defined  for  the  statement. 

169  UDDERS: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

170  DELSYN: 

NAME  NOT  IN  DATA  3ASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

171  DELSYN: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

172  DELSYN: 

NAME  IS  NOT  A  SYNONYM  FOR  THIS  NAME 

Attempt  to  delete  a  SYNONYM  relationship  which  is  not 
defined  in  the  data  base. 

173  DRIVES: 

USES  INFORMATION  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  specified 
exactly  as  it  is  in  the  data  base.  Relationship  is  not 
deleted. 

r  - -  •'.vwar 
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174  DRIVES: 

WARNING  -  "USING"  INFO  IN  DATA  BASE 

Statement  deleted  although  the  relationship  has  not 
been  specified  exactly  as  in  the  data  base  (the 
"USING"  clause  has  been  omitted). 

175  DRIVES: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

176  DRIVES: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

177  DRIVES: 

THESE  TWO  NAMES  NOT  CONNECTED  IN  THAT  WAY 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

178  HAPPNS : 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

179  DRIVES: 

.  "USES"  NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

180  HAPPNS: 

NAMES  NOT  CONNECTED 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

181  DISCON: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

182  DISCON: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

183  DISCON: 

NAMES  NOT  CONNECTED 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

184  ATVLST : 

NAME  DOESN'T  HAVE  THIS  ATTRIBUTE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

185  ATVLST: 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

Subroutine 


Error  Message 


I  urn 

186  ATVLST : 

*87  NOCNST : 

| 88  NOCNST: 

189  NOCNST: 

190  NOCNST: 

191  NOCNST: 

192  CONN: 

193  CONN: 

194  CONN: 

195  SYSVAL: 

196  PLONG: 

1*97  COUNT: 


NAME  HAS  NO  ATTRIBUTES 

Attempt  to  delete  ATTRIBUTE  relationship  for  a  name 
with  no  ATTRIBUTES. 

SYSPAR  VALUE  IN  DATA  BASE  IS  DIFFERENT  -  IGNORED 
Attempt  to  delete  a  statement  using  a  different  SYSTEM- 
PARAMETER.  Statement  not  deleted. 

WARNING  -  SYSPAR  IN  DATA  BASE 

Statement  deleted  though  user  did  not  include  SYSTEM- 
PARAMETER  with  statement. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  CONSISTS  relationship  using  a 
name  not  defined  in  the  data  base. 

CONSISTS/CONTAINED  INFORMATION  MOT  IN  DATA  BASE 
Attempt  to  delete  a  CONSISTS  or  CONTAINED  relation¬ 
ship  not  defined  in  the  data  base. 

NO  SYSPAR  IN  DATA  BASE  -  IGNORED 

Attempt  to  delete  a  relationship  which  is  not  defined 
exactly  in  the  same  way  as  defined  in  the  data  base. 
Statement  not  deleted. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

RELATION  HAS  NO  CONNECTIVITY 

Attempt  to  delete  a  CONNECTIVITY  relationship  for  a 
name  with  no  CONNECTIVITY  statements  associated  with  it. 

DIFFERENT  CONNECTIVITY  IN  DATA  BASE 
Attempt  to  delete  a  CONNECTIVITY  relationship  not 
defined  exactly  as  is  in  the  data  base.  Statement 
not  deleted. 

NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  which  is  not  defined 
in  the  data  base. 

COMMENT  NOT  FOUND  ***  SYSTEM  ERROR  *** 

url  software  error.  Please  notify  persons  maintaining 

URL  should  this  error  occur. 

COMMENT- ENTRIES  NOT  ALLOWED  IN  dpsl 
Attempt  to  delete  comment- entry  statements.  This  can 
only  be  done  using  the  DCOM  and  RCOM  commands.  State¬ 
ment  not  deleted. 
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198  COMNT: 

EOF  WHILE  LOOKING  FOR  SEMICOLON 

Improper  statement  syntax  has  been  encountered. 

Semicolons  are  needed  to  end  all  URL  statements. 

199  HAPPNS : 

DIFFERENT  SYSPAR  -  NOT  DELETED 

Attempt  to  delete  a  HAPPENS  relationship  using  a 
different  SYSTEM-PARAMETER  than  defined  in  the  data 
base.  Statement  not  deleted. 

200  HAPPNS : 

INTERVAL  NOT  IN  DATA  BASE 

Attempt  to  delete  a  HAPPENS  relationship  using  an 

INTERVAL  not  defined  in  the  data  base. 

201  PLIST: 

NAME  NOT  PART  OF  HEADER 

An  illegal  statement  header  has  been  given.  Probably 
a  spelling  error.  The  statement  is  ignored. 

202  NLIST : 

NAME  PREVIOUSLY  USED  DIFFERENTLY  -  IGNORED 

Attempt  to  use  a  name  in  a  context  different  than  the 

way  it  is  defined.  (This  error  is  also  described  in  section  10.1.) 

203  DRIVES: 

"USING"  NAME  NOT  IN  DATA  BASE 

Attempt  to  delete  a  relationship  not  defined  in  the 
data  base. 

204  DEFN: 

INVALID  NAME  TYPE 

Attempt  to  assign  a  name  type  to  a  name  which  is  used 
in  a  different  context. 

205  SETSYN: 

ALREADY  SYNONYM  FOR  SOMETHING  ELSE 

Attempt  to  assign  a  name  to  be  a  SYNONYM  for  more  than  one 
object. 

206  SETSYN: 

UNABLE  TO  MAKE  SYNONYM  -  TOO  COMPLICATED 

See  Section  10.1  part  vii  for  explanation  and  solution  to  this 
error. 

207  SETSYN: 

CANNOT  BE  MADE  SYNONYM  -  DIFFERENT  TYPES 

Attempt  to  assign  a  name  as  a  SYNONYM  to  a  different 
name,  both  with  different  name  types. 

209  SYSNL: 

NAME  MUST  BE  INTERVAL 

Attempt  to  use  a  name  v/hich  is  not  an  INTERVAL  in  a 

CONSISTS  statement  for  an  INTERVAL  section. 

210  SYSNL: 

INVALID  NAME  TYPE 

Attempt  to  use  a  name  in  a  context  different  than  the 
way  the  name  is  defined. 
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Number  Subroutine 

211  OTHERS: 

Error  Message 

NAME  MUST  BE  ENTITY  NAME 

Attempt  to  use  a  name  in  a  context  where  only  an 

ENTITY  name  is  acceptable. 

212  OTHERS: 

RELATION  ALREADY  EXISTS  BETWEEN  TOO  OTHER  ENTITIES 

Attempt  to  specify  the  same  RELATION  for  a  different 
pair  of  ENTITIES.  Different  ENTITY  pairs  imply 
different  RELATIONS. 

213  OTHERS: 

CAN  ONLY  HAVE  ONE  CARDINALITY 

Attempt  to  specify  a  second  CARDINALITY  statement  for 
a  name.  Objects  may  have  only  one  CARDINALITY. 

214  OTHERS: 

CONNECTIVITY  ALREADY  GIVEN  FOR  THIS  RELATION 

A 

Attempt  to  specify  a  second  CONNECTIVITY  statement 
for  a  name.  RELATIONS  may  have  only  one  CONNECTIVITY. 

215  OTHERS: 

ALREADY  CONTAINS  WITH  DIFFERENT  SYSTEM  PARAMETER 

Attempt  to  specify  the  same  CONSISTS  statement,  but 
with  two  different  SYSTEM-PARAMETERS. 

216  OTHERS: 

NAME  MUST  BE  ENTITY  NAME  BEFORE  VIA 

Attempt  to  use  a  name  in  a  statement  where  only  an 

ENTITY  name  is  allowed. 

217  OTHERS: 

NAME  MUST  BE  RELATION  AFTER  VIA 

Attempt  to  use  a  name  in  a  statement  where  only  a 

RELATION  name  is  allowed. 

218  OTHERS: 

RELATION  ALREADY  EXISTS  BETWEEN  DIFFERENT  ENTITY 

PAIR 

Attempt  to  specify  the  same  RELATION  for  a  different 
pair  of  ENTITIES.  Different  ENTITY  pairs  imply  different 
RELATIONS. 

219  OTHERS: 

NAME  MUST  BE  CONDITION 

Attempt  to  use  a  name  in  a  statement  where  only  a 
CONDITION  name  is  allowed. 

220  SETSYN: 

CANNOT  MAKE  A  NAME  A  SYNONYM  OF  ITSELF 

Attempt  to  specify  a  basic  name  as  a  synonym  for 
itself.  Basic  names  cannot  also  be  synonyms. 

221  NLIST : 

TOO  MANY  NAMES  -  REST  IGNORED 

Attempt  to  specify  a  list  of  names  for  a  statement 
where  only  a  single  name  is  acceptable. 

222  RWLIST : 

NAME  MUST  BE  GROUP  OR  ELEMENT 

Attempt  to  use  a  name  in  a  statement  whore  only  a 

GROUP  or  ELEMENT  name  is  acceptable. 

^  223  RWLIST: 

NAME  MUST  BE  SET,  ENTITY,  GROUP,  ELEMENT,  OR  INPUT 

Attempt  to  use  a  name  in  a  statement  where  only  a 

SET,  ENTITY,  GROUP,  ELEMENT ,  or  INPUT  is  acceptable. 
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224  RWLIST: 

IDENTIFIER  MUST  BE  GROUP  OR  ELEMENT 

Attempt  to  use  a  name  in  a  statement  where  only  a 
GROUP  or  ELEMENT  name  is  acceptable.  Only  GROUPS  and 
ELEMENTS  may  be  used  as  IDENTIFIERS. 

225  RWLIST: 

CANNOT  HAVE  KEYWORD  FOR  KEYWORD 

Attempt  to  assign  a  KEYWORD  to  a  KEYWORD  name. 

226  RWLIST: 

ONLY  RELATIONS  AND  SEC'S  CAN  BE  MAINTAINED 

Attempt  to  use  a  URL  statement  in  the  wrong  context. 

227  RWLIST: 

* 

PD  CANNOT  BE  RESPONSIBLE  FOR  PD 

Attempt  to  assign  a  RESPONSIBLE-PROBLEM-DEFINER 
to  a  PROBLEM-DEFINER  name. 

228  RWLIST: 

CANNOT  HAVE  SECURITY  FOR  SECURITY 

Attempt  to  assign  a  SECURITY  statement  to  a  SECURITY 
name. 

229  RWLIST: 

CANNOT  HAVE  SOURCE  FOR  SOURCE 

Attempt  to  assign  a  SOURCE  to  a  SOURCE  name. 

230  RWLIST: 

SSC  MUST  BE  SSC,  GROUP,  OR  ELEMENT 

Attempt  to  define  a  name,  which  is  not  a  GROUP  or 
ELEMENT,  as  SUBSETTING-CRITERIA  for  a  SET  name. 

231  ■  RWLIST: 

SYNONYMS  ONLY  APPLIED  TO  FIRST  NAME 

Attempt  to  assign  a  SYNONYM  to  more  than  one  name. 

The  SYNONYM  is  given  only  to  the  first  name. 

232  APPLES: 

APPLIES  STATEMENT  ILLEGAL  WITH  THIS  NAME  TYPE 

Attempt  to  use  APPLIES  statement  for  a  name  which  is 
not  a  KEYWORD,  MAILBOX,  SECURITY  or  SOURCE. 

233  DEFN: 

TOO  MANY  NAMES  IN  DEFINE  HEADER  -  REST  IGNORED 
Exceeded  50  name  limit,  remaining  names  should 
be  given  in  another  statement. 

234  OPTRW: 

NAME  MUST  BE  PROCESS 

Attempt  to  use  a  name  in  a  wrong  context.  Only  a 
PROCESS  name  can  be  used  in  this  context. 

235  OPTRW: 

NAME  MUST  BE  ELEMENT,  GROUP,  ENTITY,  OR  SET 

Attempt  to  use  a  name  in  wrong  context  for  an  UPDATES 
relationship. 

236  OPTRW: 

MUST  BE  ELEMENT,  GROUP,  INPUT,  ENTITY,  OR  SET 

Attempt  to  use  a  name  in  wrong  context  for  a  USES  or 
USING  relationship. 
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237  USEDTO: 

238  USEDTO: 

239  USEDTO: 

240  APPLES: 

241  APPLES: 

246  APPLES: 

247  APPLES: 

248  APPLES: 

249  APPLES: 

251  SNAMET: 

252  SETSYN: 

253  RWLIST: 

254  NAMDBK: 

256  CONTND: 


Error  Message 
MUST  BE  PROCESS  NAME 

Attempt  to  use  a  name  in  a  wrong  context.  Only  a 
PROCESS  name  can  be  used  in  this  context. 

MUST  BE  ELEMENT,  GROUP,  ENTITY,  OUTPUT,  OR  SET 
Attempt  to  use  a  name  in  the  v/rong  context  for  a 
DERIVES  relationship. 

MUST  BE  ELEMENT,  GROUP,  ENTITY,  OR  SET 
Attempt  to  use  a  name  in  the  wrong  context  for  an 
UPDATE  relationship. 

KEYWORD  CANNOT  APPLY  TO  KEYWORD 

Attempt  to  use  the  APPLIES  statement  in  the  wrong  context. 
MAILBOX  CAN  ONLY  APPLY  TO  PD 

Attempt  to  use  the  APPLIES  statement  in  the  wrong  context. 
SECURITY  CANNOT  APPLY  TO  SECURITY 

Attempt  to  use  the  APPLIES  statement  in  the  wrong  context. 
SOURCE  CANNOT  APPLY  TO  SOURCE 


Attempt  to  use  the  APPLIES  statement  in  the  wrong  context. 
MEMO  CANNOT  APPLY  TO  MEMO 

Attempt  to  use  the  APPLIES  statement  in  the  wrong  context. 
INVALID  SECTION  -  WOOPS 

URA  software  error.  Please  notify  persons  maintaining 
ura  should  this  error  occur. 


ATTEMPT  TO  CHANGE  TYPE  WHEN  ALREADY  TYPED 

ura  software  error.  Please  notify  persons  maintaining 

ura  should  this  error  occur. 

SYNONYM  TABLE  OVERFLOW 

Exceeded  ura  limits.  The  user  should  reissue  INPUT-PSL 
command  at  point  in  the  input  file  where  this  error 
occurred. 

INVALID  STATEMENT  NUMBER 

URA  software  error.  Please  notify  persons  maintaining 
URA  should  this  error  occur. 

CANNOT  CREATE  SYNONYM 

ura  software  error.  Please  notify  persons  maintaining 
URA  should  this  error  occur. 

INVALID  SECTION 

URA  software  error.  Please  notify  persons  maintaining 
ura  should  this  error  occur. 
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257  CONTND: 

MUST  BE  GROUP,  INPUT,  OUTPUT,  OR  ENTITY 

Attempt  to  use  the  CONTAINED  relationship  in  a  wrong 
context. 

258  CONTND: 

MUST  BE  SET 

Attempt  to  use  the  CONTAINED  relationship  in  a  wrong 
context.  INPUTS,  OUTPUTS  and  ENTITIES  can  only  be  ' 
CONTAINED  in  a  SET. 

259  CONTND: 

MUST  BE  GROUP,  INPUT,  OUTPUT,  OR  ENTITY 

Attempt  to  use  a  name  in  the  wrong  context  for  a 

CONTAINED  relationship. 

263  OPTRW: 

MUST  BE  ELEMENT,  GROUP,  OUTPUT,  ENTITY  OR  SET 

* 

Attempt  to  use  a  name  in  wrong  context  for  a  DERIVES 
relationship. 

264  SYNTH: 

NAME  MUST  BE  SYSPAR 

Attempt  to  use  a  name,  defined  to  be  something  else, 
as  a  SYSTEM-PARAMETER. 

265  HAPENS: 

SAME  THING,  SAME  INTERVAL,  DIFFERENT  SYSPAR 

Attempt  to  specify  same  relationship  between  two  INTERVAL 
names  though  with  different  SYSTEM-PARAMETER.  Not  allowed 

266  ILLST: 

ILLEGAL  STATEMENT  IN  THIS  SECTION 

Attempt  to  use  a  url  statement  in  a  wrong  context.  See 
"User  Requirements  Language,  Version  3.0,  Language 
Reference  Manual."* 

267  ILLST: 

NO  CURRENT  SECTION 

Attempt  to  use  an  illegal  section  header  statement.  See 
"iUser  Requirements  Language,  Version  3.0,  Language 
Reference  Manual."* 

268  USEDTO: 

NAME  MUST  BE  SET,  ENTITY,  GROUP,  ELEMENT,  OR  INPUT 

Attempt  to  use  a  name  in  the  wrong  context  for  a  USES 
relationship. 

269  NLIST : 

NAME  LIST  TOO  LONG,  REST  IGNORED 

Limit  of  50  names  has  been  exceeded.  Remaining  names 
should  be  given  in  another  statement. 

270  INPAR: 

ERROR  OPENING  DATA  BASE  -  MUST  ABORT 

Attempt  to  use  an  inconsistent  data  base.  No  processing 
can  be  done  on  it.  (See  Section  10.1.) 

271  MAINCNC: 

NAME  NOT  IN  D.B .  - 

Attempt  to  retrieve  information  for  a  name  not  defined 
in  the  data  base. 

*  ISDOS  Working  Paper  No.  68. 
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272  CNCBLD: 

273  CNCBLD: 

274  CNCBLD: 

275  CNCBLD: 

* 

276  CNCBLD: 

277  CNCBLD: 

278  CNCBLD: 

279  CNCSUM: 

280  CNCSUM: 

-  281  CNCSUM: 

282  MUST: 

283  HAVE: 

284  MAINSTR: 


TOO  MANY  ROWS  -  STOPPING  HERE 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  CNC  command. 

NAME  DOESNT  CONSIST  OF  ANYTHING  - 

No  information  can  be  presented  for  this  name  in  the 

matrix. 

TOO  MANY  LEVELS  -  LOWER  LEVEL  STUFF  IGNORED 

Too  many  levels  of  CONSISTS  information  to  be  presented. 

***THE  FOLLOWING  NAMES  ARE  INVOLVED  IN  A  LOOP: 

This  problem  should  be  corrected  by  modifying  the 
CONSISTS  statements  for  these  names. 

TOO  MANY  LEVELS  -  LOWER  LEVEL  STUFF  IGNORED 

Too  many  levels  of  CONSISTS  information  to  be  presented. 

TOO  MANY  COLUMNS  -  STOPPING  HERE 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  CONSISTS-COMPARISON  command. 

SPARSE  MATRIX  OVERFLOW  -  STOPPING  HERE 

Exceeded  limits  of  software  that  produces  the  matrix. 

***N0  COLUMNS,  OR  NO  ROWS  -  STOPPING 

No  relationships  can  be  specified  about  the  names  used 

as  input,  so  no  matrix  will  be  generated. 

LESS  THAN  2  ROWS,  NO  SIMILARITY  MATRIX 

Not  enough  information  is  available  to  generate  a  matrix. 

SPARSE  MATRIX  OVERFLOW  -  STOPPING 

Exceeded  limits  of  software  that  produces  the  matrix. 

STACK  OVERFLOW  -  CONTINUING 

Exceeded  limits  of  software  that  produces  the  report. 

An  attempt  is  made  to  recover  and  process  as  much  data 
as  possible. 

STACK  OVERFLOW  -  CONTINUING 

Exceeded  limits  of  software  that  produces  the  report. 

An  attempt  is  made  to  recover  and  process  as  much  data 
as  possible. 

TOO  MANY  LEVELS  -  CONTINUING 

Exceeded  limits  of  software  that  produces  the  report. 

An  a ttemp t  is  made  to  process  as  much  data  as  possible. 
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285  ERRPS : 

i 

THE  FOLLOWING  NAMES  ARE  INVOLVED  IN  LOOPS 

Through  incorrect  specification  of  PARTS/SUBPARTS 
statements,  loops  have  been  implied  in  structures  of 
objects  in  the  problem  statement.  The  user  should 
determine  which  PARTS/SUBPARTS  relationships  should  be 
changed  and  delete  them  via  the  DELETE-PSL  command. 

286  FRINTV: 

NO  FREQUENCY  INFORMATION  IN  DATA  BASE 

No  HAPPENS  statements  have  been  specified  in  the 
problem  statement  stored  in  the  data  base.  If  any 
output  is  desired  from  this  report,  at  least  one 

HAPPENS  statement  must  be  in  the  data  base. 

287  0  MAINIDX: 

NO  NAMES  IN  INDEX 

Attempt  to  generate  an  index  into  a  report  presenting 
no  information  about  any  names.  This  is  merely  a  warning 

288  STATPS: 

NO  NAMES  AT  LEVEL  ONE 

Attempt  to  generate  STRUCTURE  report  for  names  of 
particular  name  type  (i.e.,  PROCESS,  INPUT,  OUTPUT,  or 
INTERFACE),  but  no  names  of  this  type  currently  exist 
in  the  data  base.  To  generate  this  report  for 

PROCESS  names,  for  example,  at  least  one  PROCESS  must 
be  defined  in  the  data  base. 

289  PCLRBT: 

NO  PICTURE  AVAILABLE  FOR 

Attempt  to  generate  a  PICTURE  for  names  which  legally 
have  a  PICTURE,  but  no  information  that  was  specified 
for  this  name  can  be  presented  in  PICTURE  format. 
Information  that  may  be  presented  in  a  PICTURE  is 
any  dealing  with  interaction  of  data  and  PROCESSES 
and  structure  (CONSISTS  and  SUBPARTS  statements). 

290  SETSYN: 

NAME  ALREADY  USED  IN  DIFFERENT  CONTEXT 

Attempt  to  assign  a  name  of  UNDEFINED  name  type  as  a 
SYNONYM  to  another  name  which  has  been  used  in  some 
context  in  conflict  with  the  manner  in  which  the 

UNDEFINED  name  has  been  used. 

301  IDENTR: 

***T00  MANY  COLUMNS  —  MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as 
input  to  another  ENTITY-IDENTIFIER  command. 

302  IDENTR: 

***T00  MANY  ROWS  --  MUST  STOP  HERE  **+ 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  ENTITY-IDENTIFIER  command. 

303  IDENTR: 

***MATRJ X  OVERFLOW  --  MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 

■  iW  ■ 
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Number  Subrouti ne  Error  Message 


304  IDENTR: 

THE  FOLLOWING  NAMES  DO  NOT  IDENTIFY  ANYTHING: 

No  information  can  be  presented  in  the  matrix  for 
these  names  because  they  do  not  "IDENTIFY"  any  ENTITIES. 

305  IDENTC: 

***  TOO  MANY  COLUMNS  —  MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  ENTITY-IDENTIFIER  command. 

306  IDENTC: 

***  TOO  MANY  ROWS  --  MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  ENTITY-IDENTIFIER  command. 

307  IDENTC: 

***  MATRIX  OVERFLOW  -  MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 

308  IDENTC 

THE  FOLLOWING  NAMES  ARE  NOT  IDENTIFIED  BY  ANYTHING: 

No  information  can  be  presented  in  the  matrix  for 
these  names  because  no  "IDENTIFIED"  relationships  have 
been  specified  for  them. 

309  CONROW: 

***  TOO  MANY  COLUMNS  —  MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  CONSISTS-MATRIX  command. 

310  CONROW: 

***  TOO  MANY  ROWS  —  MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  CONSISTS-MATRIX  command. 

311  CONROW: 

THE  FOLLOWING  ARE  NOT  CONTAINED  IN  ANYTHING: 

No  information  can  be  presented  in  the  matrix  for  these 
names  because  no  "CONTAINED  IN"  relationships  have  been 
specified  for  them. 

312  CONROW: 

***  MATRIX  OVERFLOW  --  MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  this  matrix. 

313  CONCOL: 

***  TOO  MANY  COLUMNS  --  MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  CONSISTS-MATRIX  command. 

314  CONCOL: 

***  TOO  MANY  ROWS  --  MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  the  matrix. 
Names  omitted  from  the  matrix  should  be  used  as  input 
to  another  CONSISTS-MATRIX  command. 

315  CONCOL: 

THE  FOLLOWING  DO  NOT  CONSIST  OF  ANYTHING: 

No  CONSISTS  statements  have  been  used  in  conjunction 
with  the  names  listed. 

Number  Subroutine  Error  Message 


316  CONCOL:  ***  MATRIX  OVERFLOW  —  MUST  STOP  HERE  *** 

Exceeded  limits  of  software  that  produces  this  matrix. 

317  CHKREL:  NAME  ALREADY  USED  IN  DIFFERENT  CONTEXT 

Attempt  to  use  a  name  in  a  context  different  from 
its  initial  context. 
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10.  HOW  TO  CORRECT  ERRORS 


I 

Once  error  situations  are  detected,  there  must  be  some  method 
to  deal  with  them.  When  the  errors  are  caused  by  problems  in 
generating  a  report,  no  action  need  be  taken  as  no  harm  will  come 
to  the  data  base.  The  Report  Command  can  simply  be  restated  in 
correct  format  to  solve  the  problem.  If,  however,  an  error  is 
encountered  in  making  modifications  to  the  data  base  (via  Modifier 
Commands)  then  some  immediate  action  should  be  taken  if  the  problem 
definer  desires  to  maintain  a  correct  and  complete  problem  statement. 

The  errors  discovered  in  making  modifications  to  the  data  base  can 
be  "Input  Errors"  which  are  errors  discovered  by  ura  in  its  attempt 
to  process  the  information  needed  to  update  the  data  base.  All 
these  errors  are  specified  by  one  or  more  URA  error  messages  . 

The  majority  of  these  errors  occur  in  the  process  of  using  the 
*■  INPUT- PSL  command. 

The  errors  discovered  in  the  problem  statement  by  the  problem  definer 
are  called  "Logical  Errors."  No  error  diagnostics  are  generated 
by  URA  to  denote  that  an  error  has  occured.  If  a  name  was  misspelled 
in  the  input  information  used  for  INPUT-PSL,  the  name  could  be 
legal  by  URL/URA  conventions  yet  not  correct  from  the  problem  definer's 
standpoint.  "BATCH"  and  "BATHC"  arc  both  names  that  would  be  perfectly 
acceptable  to  URA  but  not  to  the  problem  definer. 

The  following  two  sections  deal  with  aiding  the  problem  definer  in 
correcting  both  Input  Errors  and  Logical  Errors  should  they  occur. 
Treatment  of  the  error  correction  methodology  is  still  at  a  cursory 
level  and  no  attempt  is  made  to  present  procedures  to  correct  all  possible 
errors . 

10.1  Input  Errors 

As  stated  before,  all  input  errors  cause’jRA  error  diagnostics 
to  be  printed.  There  are  a  few  classes  of  errors  which  happen 
again  and  again  and  so  will  be  described  below. 

Inconsistent  Data  Base 


This  error  is  usually  identified  by  getting  the  URA  error:  "UR/270: 
INPAR:  ERROR  OPENING  DATA  BASE."  This  error  might  occur  after 

issuing  a  URA  Modifier  or  Report  Command  and  it  specifies  that  the 
contents  of  the  file  being  used  as  a  pra  data  base  cannot  be 
accessed  by  theuRA  software.  Methods  for  correcting  this  situation 
are  installation-dependent  since  it  involves  the  manner  in  which 
files  are  created  and  initialized.  Sec  Section  10.1  of 

Part  II  for  solutions  to  this  problem  at  a  particular 

installation. 

URA  Statement  Errors 


These  errors  account  for  the  majority  of  the  errors  encountered 
when  inputting  information  into  the  data  base  via  INTUT-PSL.  These 
errors  are  caused  by  improper  use  of  URL  statements  according  to 
the  rules  specified  in  the  "lUser  Requirements  Language,  Version 
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3.0,  Language  Reference  Manual."*  An  occurrence  of  any  of  these 
errors  results  in  the  statement,  where  the  error  occurred,  being 
ignored  by  the  system. 

The  "$"  character  printed  by  URA  is  usually  fairly  close  in 
pointing  out  where  the  error  occurred.  Some  of  the  more  common 
errors  (and  solutions)  are  presented  here  in  hopes  that  the  users 
will  be  able  to  apply  the  methods  of  solving  these  errors  to  their 
own,  specific  needs. 

i)  Syntax  Errors 

These  errors  are  often  encountered  through  misspellings, 
improper  format  of  the  statement  or  improper  usage  of 
URL  reserved  words.  URA  usually  generates  either  of  the 
two  error  messages: 

URA 010: REDUCE:  NO  APPLICABLE  PRODUCTION-SYNTAX  ERROR-START  SKIPPING 
or, 

URA  Oil : STACK:  ILLEGAL  SYMBOL  PAIR-SYNTAX  ERROR-START  SKIPPING 
For  example,  if  upon  misspelling  the  RECEIVES  statement: 

RECIEVES  FOLDER-A, FOLDER-B ; 

URAwill  react  by  printing  the  URA010  error  message  and  skip 
that  statement  to  go  on  to  the  next.  There  are  some  further 
problems  that  can  then  occur.  If  the  error  occurred  in  a 
header  statement,  such  as  PROCESS,  then  the  header 
statement  is  skipped  and  all  statements  intended  to  be  related 
to  the  header  statement  will  be  related  to  the  previous  header 
statement.  Wien  a  reserved  word  is  misspelled  URA  has  no 
way  of  knowing  if  the  statement  was  to  be  a  header  statement 
or  not.  Take  the  example: 

GROUP:  Gl; 

CSTS:  El,  E2,  G2; 

PROCCESS:  PI; 

RCVS:  II,  12; 

SUBPARTS  P2,  P3; 

ELEMENT  El,  E2; 

PROCESS  has  been  misspelled  which  results  in  having  that 
header  statement  skipped.  All  the  statements  following  this 
header  are  related  to  the  previous  header  which  leads  to  more 
problems  since  statements  which  can  only  be  associated  to 
a  PROCESS  are  being  attributed  to  a  GROUP  name.  More  errors 
will  occur  from  this  resulting;  hence,  the  PROCESS,  RCVS  and 
SUBPARTS  statements  will  not  be  entered  into  liic  data  base. 

To  correct 


t 
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this  error,  the  statements  that  were  omitted  could  be 
entered  by  another  INPUT-PSL  command.  A  far  more  serious 
problem  occurs  if  the  "previous"  header  was  also  a  PROCESS. 

For  example: 

PROCESS  PX; 

RCVS :  11,13; 

GENS:  01,02; 

PROCCESS  PI; 

RCVS  11,12; 

SUBPARTS  P2,P3; 

ELEMENT  E1,E2; 

If  this  were  the  case,  then  only  one  error  would  be  caught 
by  URA  (the  misspelled  "PROCESS")  and  the  following  RCVS 
and  SUBPARTS  statements  would  be  attributed  to  PROCESS  PX. 

If  this  mistake  were  discovered,  the  user  would  have  to 
delete  the  two  statements  from  PX  and  then  reinput  the 
information  for  PI: 

DELETE- PSL 
PROCESS  PX; 

RCVS  11,12; 

SUBPARTS  P2,P3; 

EOF 

INPUT-PSL  UPDATE 
PROCESS  PI; 

RCVS  11,12; 

SUBPARTS  P2,P3; 

EOF 

ii)  Illegal  Statement 

This  error  is  designated  by  the  URA  error: 

URA266 : ILLST :  ILLEGAL  STATEMENT  IN  THIS  SECTION 

This  error  can  be  caused  simply  by  using  a  statement  that 
is  not  allowed  for  that  particular  section.  Using  a  CONSISTS 
statement  in  a  PROCESS  section  would  obviously  generate  this 
error.  The  other  case  occurs  when  an  error  is  made  in  a 
header  section  statement  and  all  the  following  statements 
might  be  incompatible  with  the  previous  header  section  name. 
Whenever  this  error  is  encountered,  the  statement  is  not 
put  into  the  data  base. 

i i i )  Illegal  Header  Statement 

If  an  error  occurs  in  a  header  statement  and  URA  Is  able  to 
identify  it  as  a  header  statement,  the  following  error  will 
be  given: 

URA025 :HEAD:  INVALID  HEADER  STATEMENT -STATEMENTS  WILL  BE  IGNORED 

This  means  that  all  the  statements  up  to  the  next  header 
statement  will  be  ignored  and  not  input  into  the  data  base. 
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All  the  statements  ignored  must  be  reinputted  using  another 
INPUf-PSL  command  to  be  put  into  the  data  base. 

iv)  Input  Line  Too  Long 

If  a  number  of  URL  statements  are  used  on  one  line  of  the 
input  file  or  if  the  URL  statement  is  very  long,  it  may 
run  over  the  72  column  restriction.  Should  this  occur, 
usually  URA 010  orURAOll  will  be  generated  specifying  that 
improper  syntax  has  been  encountered.  Note  that  no  error 
message  is  generated  for  the  fact  that  the  statement  runs 
over  the  72  column  restriction.  Errors  are  encountered  because 
anything  over  column  72  is  ignored.  Therefore,  names  may  be 
truncated  or  a  semicolon  lost. 

v)  Name  Too  Long 

It  is  an  easy  thing  to  mistake  a  31  or  32  character  word 
for  30  characters.  Names  longer  than  30  characters 
are  caught  by  URA  and  flagged  by  the  error: 

URA  022 :NLEX:  NAME  TOO  LONG 

The  statement  that  used  the  name  is  still  entered  into  the 
data  base  but  the  name  is  stored  in  a  truncated  form  in  the 
data  base.  If  the  truncated  form  of  the  name  is  not  satis¬ 
factory,  it  is  a  simple  matter  to  change  the  name  via  the 
RENAME  command. 

vi)  Using  URA  Reserved  Words  Incorrectly 

Most  syntax  errors  are  fairly  easy  to  detect;  a  misspelled 
word,  improper  format,  etc. ,  but  one  of  the  hardest  to  detect 
is  the  improper  use  of  a  URL  reserved  word.  For  example, 
the  following  statement  would  be  flagged  by  a  URADIO  or 
UR70U  error  message  as  having  a  syntax  error. 

ATTRIBUTE  TYPE  A; 

The  letter  "A"  happens  to  be  a  URL  optional  word  and  cannot 
be  used  as  a  user-defined  name.  Detecting  these  reserved 
words  can  get  trickier  than  this,  however,  as  the  statement: 

PROCESS  D,F,G, K; 

seems  correct,  but  "F"  is  the  abbreviation  of  the  URL 
reserved  word  "FALSE."  The  key  to  finding  these  errors  is 
to  watch  where  the  "$"  character  is  printed  by  URA  •  It  is 
usually  printed  directly  after  the  location  of  the  source 
of  the  error.  The  statement  is  ignored  should  this  type  of 
error  occur  and  the  only  solution  is  to  reinput  the  data 
using  a  different  name.  A  list  of  all  URL  reserved  words 
is  given  in  Appendix  B  of  the  "User  Requirements  Language, 
Language  Reference  Manual."* 
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vii)  Synonym  Too  Complicated 

This  error  is  specified  by  the  IURA  error: 

URA206:SETSYN:  UNABLE  TO  MAKE  SYNONYM-TOO  COMPLICATED 

This  is  caused  by  specifying  various  relationships  about 
two  names  and  then  attempting  to  make  one  a  SYNONYM  of  the 
v  other.  The  problem  lies  in  combining  these  relationships. 

The  statements: 

GROUP  Gl; 

»  USED  BY  P2 ; 

PROCESS  LONG -PROCESS -NAME; 

SUBPARTS  P3,P4; 

SYNONYM  P2 ; 

*•  will  generate  the  error.  P2  is  implicitly  defined  to  be  a 

PROCESS  just  in  the  context  in  which  it  is  used  in  the 
second  statement;  it  also  has  a  relationship  with  Gl. 

Now  LONG-PROCESS-NAME  is  defined  and  has  relationships 
formed  with  P5  and  P4.  In  the  last  statement,  an  attempt 
was  made  to  make  P2  and  LONG-PROCESS-NAME  the  same  PROCESS 
and  the  error  is  generated.  The  whole  problem  could  have 
been  avoided  if  the  user  had  maintained  the  convention  of 
issuing  SYNONYM  statement  directly  after  the  header  statement  as 
shown  below: 

GROUP  Gl; 

USED  BY  P2 ; 

PROCESS  LONG-PROCESS-NAME; 

SYNONYM  P2 ; 

SUBPARTS  P3;P4; 

If  the  statements  had  been  inputted  in  this  manner,  LONG- 
PROCESS-NAME  would  not  have  had  any  relationships  formed 
with  other  names  (P3  and  P4  in  the  previous  example)  and 
the  assignment  of  P2  as  a  SYNONYM  would  have  been  successful. 

Since  the  error  does  occur,  there  exists  a  method  of 
correcting  this  problem: 

1.  Retrieve  all  information  for  one  of  the  names  via 
the  PUNCH  parameter  for  the  FPS  command. 

2.  Delete  the  name  for  which  the  information  was 
retrieved  from  the  data  base. 

3.  Alter  the  PUNCH  information  so  that  all  the 

.  information  now  pertains  to  the  name  still  in 

the  data  base. 

w  4.  Enter  the  modified  PUNCH  information  as  input  to 

the  INPUT- PSL  command. 
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In  this  way,  all  information  about  P2  is  given  to  LONG-PROCESS- 
NAME  and  P2  is  assigned  as  a  SYNONYM  if  future  references  to 
the  name  are  necessary.  It  is  much  easier  to  maintain  the 
convention  of  assigning  SYNONYMS  directly  after  the  header 
statement . 

viii)  Names  Used  in  Wrong  Context 

This  type  of  error  accounts  for  the  majority  of  the  error 
messages  presented  in  Section  9. 

URA202 :NLIST:  NAME  PREVIOUSLY  USED  DIFFERENTLY- IGNORED 
and, 

URA222 :RWLIST :  NAME  MUST  BE  GROUP  OR  ELEMENT 

are  examples  of  diagnostics  presented  for  this  type  of 
error.  The  statement  will  be  ignored  and  the  only  way 
to  resolve  the  problem  is  to  reinput  the  information  in 
an  acceptable  format. 

ix)  Breaking  Section/Statement  Rules 

Several  error  messages  can  be  generated  by  attempting  to 
break  the  rules  set  forth  in  the  "User  Requirements  Language, 
Version  3.0,  Language  Reference  Manual,"*  for  statements 
within  a  particular  section.  In  using  the  PART  statement, 
for  example,  an  object  may  be  PART  of  only  one  object  and 
failure  to  comply  with  this  rule  will  result  in: 

URA061 :RWLIST:  ALREADY  PART  OF  SOMETHING  ELSE 

or  some  analogous  URA  error  message.  These  error  checks  are 
■  made  to  enforce  the  rules  set  forth  in  the  "Language  Reference 
Manual"  and  ensure  that  the  problem  statement  is  still  mean¬ 
ingful.  Other  messages  presented  for  this  type  of  error  are: 

URA2 14: OTHERS:  CONNECTIVITY  ALREADY  GIVEN  FOR  THIS  RELATION 

or, 

URA060: APPLES:  SECOND  MAILBOX  FOR  PD  ILLEGAL 

If  the  user  wishes  to  replace  the  information  stated  in  the 
data  base,  e.g.,  replace  the  MAILBOX  for  a  problem  definer, 
the  relationship  should  be  deleted  via  DELETE-PSL  and  then 
the  correct  information  should  be  inputted  using  the  INPUT- 
PSL  command. 
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JO. 2  Logical  Errors 


These  errors  occur  when  inputting  information  into  the  data  base 
(as  input  errors  do),  but  no  diagnostics  are  given  in  the  AS-IS 
SOURCE  LISTING.  These  errors  might  be  detected  by  scanning  the 
complete  list  of  names  in  the  data  base  (NAME-GEN)  and  the  complete 
problem  statement  (FORMATTED-PROBLEM-STATEMENT) .  These  errors 
can  also  be  detected  when  reviewing  the  contents  of  any  of  the 
other  reports  available  on  URA. 

Misspelled  Names 

A  simple  spelling  error  can  result  in  two  names  which,  look  very 
similar,  but  which  are  treated  as  two  different  objects  in  the 
data  base. 

For  example,  if  the  name,  "CALENDAR- DAY"  was  used  to 
specify  a  particular  INTERVAL  in  the  data  base  and 
then  "CALENDAR-DAYS"  is  used  in  the  statements: 

INTERVAL:  CALENDAR-week ; 

CONSISTS:  7  CALENDAR-DAYS; 

the  two  names  become  completely  different  objects  (to  URA). 

URA  does  not  know  that  the  two  are  the  same  object  and  it 
is  up  to  the  user  to  detect  and  correct  this  mistake  which 
can  be  done  in  the  following  manner. 

1.  Retrieve  all  information  for  one  of  the  names 
via  the  PUNCH  parameter  for  the  FPS  command. 

2.  Delete  the  name  for  which  the  information  was 
retrieved  from  the  data  base. 

3.  Alter  the  PUNCH  information  so  that  all  the  infor¬ 
mation  now  pertains  to  the  name  still  in  the  data 
base. 

4.  Enter  the  modified  PUNCH  information  as  input  to 
the  1NPUT-PSL  command. 

The  effect  of  doing  this  for  the  previous  example 
would  be  that 

i)  All  information  given  about  CALENDAR-DAYS  is 
transferred  to  CALENDAR- DAY  and  then  CALENDAR- 
DAYS  is  deleted  from  the  data  base.  If  it  is 
desirable  to  use  the  plural  form  of  the  name  in 
the  data  base  then  it  should  be  a  SYNONYM,  this 
can  be  done  in  a  DESIGNATE  statement: 

INPUT- PSL 

DF.SG  CALENDAR- DAYS  SYNONYM  CALENDAR-DAY; 

EOF 
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ii)  Since  names  can  consist  of  letters  or  numbers, 
another  common  misspelling  error  is  to  substi¬ 
tute  the  letter  "0"  for  the  number  "0".  It  is 
often  very  difficult  to  detect  this  and  so 
there  appear  to  be  two  names,  spelled  exactly 
the  same  in  the  data  base.  This  can  be  corrected 
in  the  same  way  as  the  previous  problem. 

iii)  When  the  spelling  error  only  involves  one  name 

(if  TIME-CARD  was  spelled  TIMECARD  in  all  instances) 
then  this  problem  could  easily  be  solved  by 
using  the  RENAME  command: 

RENAME  0= TIMECARD  N=TIME-CARD 

t 

If  both  TIME-CARD  and  TIMECARD  are  defined  in  the 
data  base,  then  the  same  procedure  used  to  change 
CALENDAR-DAYS  must  be  performed. 

Redundant  Objects 

Another  error  which  occurs  quite  frequently  is  to  define  one 
object  by  two  different  names,  not  realizing  that  they  are 
representing  the  same  thing.  EMPLOYEE -RECORD  and  EMPLOYEE-DATA 
may  be  defined  separately  in  the  data  base,  but  represent  the 
same  thing.  To  resolve  this  redundancy,  the  information  for  the 
two  names  must  be  combined.  This  can  be  done  in  the  same  manner 
as  given  for  correcting  the  misspelled  names  (involving  two  names). 

Missing  Semicolons 

Most  often,  a  missing  semicolon  will  be  detected  as  a  syntax  error 
(as  described  in  Section  10.1).  There  is  one  particular  case 
where  a  missing  semicolon  would  not  generate  any  error  message: 

PROCESS  PI; 

DESCRIPTION; 

THIS  IS  A  DESCRIPTION  COMMENT  ENTRY  THAT  IS  MISSING 
THE  SEMICOLON. 

RCVS  11,12; 

GENS  01,02; 

What  happens  here  is  that  the  RCVS  statement  becomes  part  of  the 
DESCRIPTION  comment  entry.  A  semicolon  was  omitted  in  terminating 
the  lines  intended  to  be  the  comment  entry,  but  URA  simply  searches 
for  the  first  semicolon  to  signify  the  end  of  the  comment  entry. 

To  solve  this  problem  the  DESCRIPTION  statement  must  be  replaced 
and  the  RCVS  statement  must  be  added  to  the  data  base.  This  can 
he  accomplished  by  the  following  procedure. 

1.  Generate  the  incorrect  comment  entry  in  the  form  of  PUNCH 
information  (via  the  PUNCH- COMMENT-ENTRY  command) . 

2.  Alter  the  PUNCH  information  so  that  the  comment  entry  is 
correct . 
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3.  Use  the  modified  PUNCH  information  as  input  to  the  REPLACE- 
COMMENT-ENTRY  command. 

4.  Add  the  RCVS  statement  via  an  INPUT-PSL  command. 

Correctness  and  Completeness 

For  the  most  part,  it  is  up  to  the  problem  definer  to  maintain 
correctness  of  the  problem  statement  and  URA  maintains  correctness 
of  the  data  base.  The  problem  definer  has  the  ability  to  do  this 
through  usage  of  the  DELETE-PSL  and  INPUT-PSL  commands.  Complete¬ 
ness  can  also  be  determined  by  the  problem  definfer  or  improved 
through  use  of  the  INPUT-PSL  command. 
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Part  II 

USAGE  of  the  USER 
REQUIREMENTS  ANALYZER 


under  MULTICS 
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1.  INTRODUCTION 


URA  extracts  information  from  URL  statements  and  stores  it  in  a 
URA  data  base.  Once  this  information  (a  requirements  statement) 
is  in  the  data  base,  it  can  be  modified,  new  information  can  be 
added  to  it,  and  reports  can  be  generated  presenting  the  status 
of  the  requirements  statement.  These  actions  are  implemented  by 
the  URA  commands  available  in  the  URA  processing  mode.  This  mode 
of  operation  may  be  attained  by  accessing  the  URA  software  available 
under  Multics.  Therefore,  by  understanding  the  Multics  commands 
that  aid  in  interacting  with  URA,  and  the  URA  command  language,  the 
URA  user  can  effectively  manipulate  the  contents  of  a  URA  data  base. 

This  paper  specifies  those  Multics  commands  commonly  used  in 
interacting  with  URA  and  how  to  use  them.*  Multics  and  URA  commands 
can  only  be  used  in  their  respective  processing  modes.**  Multics 
commands  can  be  used  from  the  time  of  logging  on  to  Multics,  to 
the  time  access  is  made  to  the  URA  software.  Once  the  user  enters 
URA  mode,  only  URA  commands  may  be  used  until  the  URA  user  terminates 
processing  to  be  done  in  URA  mode  (through  use  of  the  URA  ’’stop" 
command).  Multics  commands  can  then  be  issued  until  the  user  either 
logs  out  of  Multics,  or  re-enters  URA  mode.  This  interaction  between 
Multics  and  URA  modes  is  better  illustrated  by  Figure  19« 

The  format  of  this  paper  serves  an  important  purpose.  The  first 
five  sections  deal  with  Multics  and  URA  at  an  introductory  level. 
Section  2  presents  necessary  information  on  the  basic  use  of 
Multics.  Section  3  explains  the  procedure  of  accessing  URA  once 
on  Multics.  Sections  4  and  5  present  practical  concepts  and 
conventions  which  aid  in  using  URA  under  Multics.  Once  access 
to  URA  has  been  achieved,  sections  6,  7  and  8  present  the  manner 
in  which  Multics  interacts  with  the  various  commands.  Several 
examples  are  given  in  those  sections  in  order  to  better  illustrate 
the  results  of  specific  implementations.  Section  9  deals 
with  using  Multics  to  handle  errors  encountered  in  the  use  of  URA. 

2.  Using  Multics 

For  an  introduction  to  Multics,  see  the  Multics  User’s  Guide, 
Honeywell  Order  Number  AL40.  For  a  more  detailed  explanation  of 
Multics  facilities,  see  the  Multics  Programmers  Manual  (MPM) . 

3.  The  URA  Environment 

Assuming  that  the  user  is  already  logged  in  to  Multics,  a  URA 
data  base  with  the  name  "psabb .  dbf ’’  may  be  initialized  by  the 
following  command: 


*  For  a  better  understanding  of  the  whole  Multics  system  and  commands 
available,  see  the  Multics  Programmer’s  Manual,  the  Multics  Users 

C  (Honovvell  Order  Number  Af/iO)  and  any  c-;*ctr  2n :  at  i <*n  provided 

by  your  local  installation. 

**  A  processing  mode  is  defined  by  the  software  system  in  control  when 
any  type  of  command  Is  issued.  The  debug  facility,  the  editor,  URA , 
etc.,  all  define  processing  modes  and  thus,  a  particular  set  of 
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Multics  mode 


other  Multics 
commands 


Figure  19.  Interaction  Between  Multics  and  URA  Processing  Modes 
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exec_com  >udd>project>personid>dbin  psadb  >udd>project>personid>psa 

This  will  create  an  empty  initialized  data  base  of  the  default 
size  in  the  current  working  directory  To  create  a  data  base 
with  a  non-default  size  see  Appendix  B  for  creating  data  bases. 

Once  a  data  base  has  been  initialized,  the  user  may  enter  URA  mode 
with  the  Multics  commands: 

exec__com  >udd>pro  ject>personid>ura 

This  command  is  used  whenever  the  user  wishes  to  enter  URA  mode, 
whereas  a  data  base  need  only  be  initialized  at  the  beginning 
of  a  project.  Should  a  user  desire  to  expand  or  reorganize  his 
data  base,  the  dump/restore  programs  described  in  Appendix  C  may 
be  used. 

4.  Specifying  Input  to  URA  Commands 

This  section  specifies  information  relevant  to  using  and 
manipulating  Multics  segments  to  be  used  as  input  files  to  URA 
commands.  The  "input”  and  "file”  paramters  of  URA  commands  may 
be  used  with  standard  Multics  segments  or  input  may  be  specified 
as  coming  from  the  terminal  in  an  interactive  mode. 

4.1  Entering  Data  into  a  Data  Set 

Using  one  of  the  Multics  editors,  the  user  can  create  segments  to 
be  used  with  the  "input”  and  "file"  parameters.  Such  segments  may 
contain  names,  URL  statements,  etc. 

If  the  user  has  URL  statements  in  the  segment  named  mos. input .psl 
in  the  current  working  directory,  he  may  use  it  as  input  for  the 
ip  command  as  follows: 

ip  input=mos . input .psl  update 

4.2  Specifying  input  data  interactively 

It  is  usually  advantageous  to  enter  data  into  segments  before  it 
is  used  as  input  to  URA  as  the  user  may  correct  errors  and  omissions 
without  difficulty  using  the  Multics  editor.  There  are  times  when 
the  user  may  wish  to  enter  data  directly  to  the  Analyzer.  In  such 
cases,  the  user  specifies  "term"  instead  of  the  segment  name.  For 
example,  to  provide  input  via  the  terminal  for  the  ip  command,  use: 

ip  input=term  update 

5.  Receiving  Output  from  URA  Commands 

This  section  specifies  information  relevant  to  using  and  manipulating 
Multics  segments  to  be  used  as  output  for  URA  commands.  In  Multics, 
output  files  are  specified  in  the  output  parameter  of  the  URA  set 

command,  and  via  the  punch  parameter  for  other  URA  commands. 


105 


5.1  Using  the  Output  Parameter 

The  output  parameter  in  the  URA  set  command  allows  the  problem 
definer  to  specify  where  all  reports  generated  by  URA  commands 
are  to  be  printed.  If  nothing  is  specified,  all  output  is  sent 
to  the  terminal.  To  specify  that  output  is  to  be  sent  to  a 
segment : 

set  output =segment-name 

From  this  point,  all  reports  generated  by  URA  will  be  written 
into  this  segment.  The  report  output  may  be  reassigned  to  the 
terminal  by: 

set  output=term 

5.2  Using  Punch  Segments 

For  some  commands,  a  punch  file  is  produced.  If  the  user  does  not 
explicitly  assign  the  punch  file,  a  default  segment  name  will  be 
used.  These  default  segment  names  are  given  in  Appendix  E. 


6.  Control  Commands 

These  commands  control  the  operation  of  URA  in  some  way  without 
actually  causing  any  output  themselves. 

6.1  Set  Command 

The  most  common  use  of  this  command  is  to  change  the  default  data 
base,  or  to  reroute  the  report  output.  To  change  the  data  base  to 
be  used  on  subsequent  commands: 

set  db^data-base-segment-name 

If  the  user  has  a  non-default  size  data  base,  he  may  wish  to  use 
the  dbt  parameter: 

set  dbt=table-segment-name 

6.2  S  top  Command 

This  command  return  to  Multics  command  mode.  All  parameters 
changed  via  the  URA  set  command  return  to  their  default  values. 
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7 


Modifier  Commands 


change- type 
delete 

delcte-comment-entry 

delcte-psl 

input-psl 

punch-comment-entry 

rename 

replace-comment-entry 


8.  Report  Commands 

consist-comparison 

consist  matrix 

data-process 

dictionary 

entity-identifier 

extended-picture 

forma  tted-problem-s tatement 

kwic 

picture 

print-attribute-values 

process-chain 

process-input-output 

punch-comment-entry 

9.  Error  Conditions 

In  addition  to  error  comments  generated  by  the  URA  system, 

there  are  occasional  errors  associated  with  the  interaction  between 

the  URA  system  and  Multics. 

9.1  Initial  messages 

When  the  user  first  enters  URA  mode,  he  will  receive  messages 
from  Multics  that  "io-switch  does  not  exist."  These  may  be 
ignored. 

9.2  Abnormal  Termination 

If  any  of  the  commands  is  unable  to  terminate  in  the  normal 
manner,  the  Fortran  monitor  may  be  entered  before  URA  has  had 
a  chance  to  close  all  files.  The  Fortran  monitor  will  ask  the 
user  if  these  files  are  to  be  closed.  In  all  cases,  the  user 
should  answer  "yes." 
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9.3  Data  Base  Already  Open 


It  is  possible  for  the  user  to  get  into  a  state  where  URA 
cannot  open  his  data  base  because  it  thinks  that  it  is  already 
open.  If  this  happens,  the  user  should  return  to  Hultics  mode, 
then  issue  the  Hultics  command  new_process. 
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Part  III 

URA  OUTPUTS 
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1. 


INTRODUCTION, 


Once  a  URL  description  of  an  information  processing  system  has  ' 

been  entered  into  a  URA  data  base  the  user  has  the  option  of 

retrieving  the  stored  information  in  several  different  standard 

formats  called  URA  reports.  Each  URA  report  has  particular 

characteristics  with  respect  to  its  purpose,  the  amount  of 

retrieval  and  analysis  required  to  generate  the  report,  the 

information  presented  in  the  report,  the  format,  etc.  In  this 

sense,  each  report  can  be  classified  by  its  characteristics  to  M 

provide  an  overall  description  of  the  report  and  to  aid  in 
determining  how  the  report  may  be  used  to  aid  problem  definers 
in  checking  the  validty  of  the  URL  description  and  to  improve 
on  its  completeness. 

Only  the  reports  generated  by  report  commands  will  be  presented 
in  this  paper.  The  reports  generated  by  modifier  commands  are 
described  in  the  "User  Requirements  Analyze*^  Part  I. 

The  manner  of  specifying  input  to  report  commands  is  given  in 

Section  4  of  Fart  I  and  Section  4  of  Part  XI»  The  jaanner  of _ L 

receiving  output  Tram  report ~coaiaafldg  is  given  in  Section  5  of 

Fart  I  and  Section  5  of  Part  IT*  I 

j 

! 

Section  2  of  Part  III  presents  the  objectives  of  PSA  reports 

with  respect  to  those  relationships  to  the  logical  system  design  i 

process  and  their  advantages  in  the  system  documentation  procedure. 

Section  3  describes  the  manner  in  which  information  is  extracted 
from  a  URA  data  base  to  produce  reports. 

Section  4  presents  several  categories  for  classifying  and  describing 
URA  reports  based  on  contents,  format  and  usage.  Section  5  consists 
of  descriptions  of  each  of  the  standard  URA  reports  available  in 
Version  A2.1  of  URA  . 
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2.  OBJECTS  OF. REPORTS  FROM  A  URA  DATA  BASE 


2.1  Purpose  of  URA  Reports 

The  purpose  of  URA  Reports  is  to  present  information  retrieved 
from  a  URA  data  base  (which  contains  the  description  of  a 
particular  system)  in  a  format  which  is  useful  to  persons  who 
are  documenting  the  target  system,  who  desire  to  understand 
the  target  system,  or  who  are  involved  in  the  design  of  the 
target  system. 

This  requires  that  the  reports  must  be  of  various  formats, 
contain  various  types  and  levels  of  information,  and  be  oriented 
at  the  various  types  of  user’s, 

With  respect  to  those  persons  documenting  the  target  system, 
the  reports  must  present  information  resulting  from  modifications 
to  the  URA  data  base.  (These  reports  are  presented  in  "iJser  Re¬ 
quirements  Analyzer  #  Part  I  11  )  In  addition,  reports 

must  present  the  status  of  the  URA  data  base  after  modifications 
have  been  made  (i.e.,  succssful  modifications).  Those  reports 
are  basically  the  same  as  those  used  by  people  who  desire  to 
understand  the  target  system.  They  present  selected  portions 
of  the  information  in  the  data  base  in  various  formats.  A  few 
particular  reports  may  also  be  used  to  aid  those  persons 
designing  the  target  system.  They  usually  present  the  results 
of  extensive  analysis  on  information  in  the  data  base. 

2 . 2  Relation  of  URA  Reports  to  Logical  System  Design 

There  are  two  major  objectives  in  logical  system  design: 

-  To  produce  a  proposed  system  that  is  the  best  possible 
in  terms  of  what  it  will  cost  to  build,  cost  to  operate 
and  what  it  will  contribute  to  the  organization. 

-  To  minimize  the  cost  and  time  to  produce  this  "optimum" 
target  system. 

Tiie  goal  of  developing  computer-aided  methods  for  use  in 
logical  system  design  is  to  contribute  to  the  above  objectives. 

At  the  present  tine,  it  is  not  possible  to  achieve  an  optimum 
solution  for  both  of  these  objectives.  One  contribution  that 
can  be  made  by  a  computer-aided  methods  is  to  improve  the 
"quality"  of  the  description  of  the  target  system.  Quality 
is  defined  in  terms  of  consistency,  unambiguity  and  completeness. 

Consistency  means  that  no  statements  made  in  the  description 
contradict,  or  are  incompatible  with,  other  statements  and 
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any  particular  object  is  referred  to  by  the  same  name  throughout 
the  description. 

Unambiguity  means  that  statements  and  relationships  are  made  so 
precisely  that  interpretation  is  uniform  by  all  readers. 

Completeness  means  that  all  necessary  relationships  are  given 
and  no  objects  have  been  omitted  from  the  description. 

The  quality  objectives  can  be  aided  at  three  levels: 

1.  URA  will  enforce  consistency  and  unambiguity  through  the 
syntax  analysis  and  reference  checks  made  when  data  is 
entered  into  the  URA  data  base. 

2.  The  URA  reports  will  make  it  easier  for  the  problem  definer 
to  detect  logic  errors  in  the  problem  statement,  unresolved 
conditions,  etc. 

3.  Some  reports  are  available  to  the  problem  definer  to  aid 
in  detecting  incompleteness  and  inconsistencies  of  the 
problem  statement. 

Therefore,  the  first  objective  in  logical  system  design  can  be 
attained  by  improving  the  quality  of  the  documentation. 

The  second  objective,  that  of  minimizing  design  cost  and  time, 
is  aided  by  transferring  much  of  the  clerical  workload  to  the 
computer.  The  Analyzer  URA  maintains  an  up-to-date  record 
of  all  information  collected.  The  preparation  of  this  information 
for  use  by  analysts,*  management,  etc.,  can  be  readily  retrieved 
at  request. 

To  meet  these  objectives ,  URA  offers  three  classes  of  outputs: 

-  Reports  to  aid  the  analyst 

-  Reports  to  aid  the  project  management 

-  Reports  to  aid  the  designer 

-  Final  specifications 

Reports  to  aid  the  analyst  are  basically  those  which  aid  in  resolving 
inconsistencies,  ambiguities,  and  incompleteness  in  the  logical 
sysstesm  design  problem  statement. 


OTU:  Throughout  this  paper,  the  terms  analyst  and  problem  definer 

are  ub#<1  synonymously*  The  problem  definer  is  a  person  responsible 

j.or  \ui_Ljn-  a  .  description  (or  pare  oi  one)  in  URL.  A  URA 

user  is  a  person  who  use::  the  URA  software  to  update  or  retrieve 
information  f rorn  a  URA  data  base. 


Sw,  The  reports  «of  concern  to  project  management  pertain  to  status 

of  the  project  in  the  form  of  amount  of  information  entered  into 
the  URA  data  base,  etc.  The  reports  which  are  of  benefit  to 
the  designer  are  those  which  reflect  inconsistencies  and  incomplete¬ 
ness  in  the  problem  statement  which  must  be  resolved  in  order  to 
develop  a  design  for  the  proposed  system.  They  also  present 
information  in  a  manner  that  optimal  or  feasible  designs  may  be 
formulated. 

The  final  specifications  are  the  end  result  of  the  logical  system 
design  phase  using  URL/URA  .  They  express  all  the  information  in 
the  URA  data  base  in  an  easy-to-read  format.  These  specifications 
consist  of  a  series  of  URA  reports  generated  in  a  particular  order 
and  format. 

2.3  Advantages  of  Using  URA  Reports 

In  contrast  to  manually  produced  documentation,  (i.e.,  handwritten 
or  typed,  the  URA  reports  have  several  advantages  with  respect  to 
maintainability,  format,  usefulness,  etc.). 

Maintainability 

All  changes  made  to  the  URL  description  of  an  Information  Processing 
System  are  made  via  the  URA  data  base.  All  documentation  (URA 
^  reports)  produced  from  the  information  in  the  data  base  after  a 

change  is  up-to-date.  There  is  no  need  to  change  previous  l 

documentation. 

Changes  made  to  manually  maintained  descriptions  usually  require 
modification  of  all  existing  sets  of  documentation,  and  modification 
of  each  portion  of  the  documentation  affected  by  the  change.  This 
process  can  cause  serious  errors  in  the  documentation  or  require 

extensive  rewriting  (and  retyping)  of  the  previous  documentation.  j 

t 

Format  ; 

Each  URA  report  is  formatted  according  to  the  purpose  of  the 
report,  taking  into  consideration  the  orientation  of  persons 
intended  to  use  the  report.  Therefore,  information  consisting 

of  many  complex  relationships  may  be  presented  in  a  graphical  { 

format,  to  make  the  information  easier  to  interpret.  Likewise,  I 

a  matrix  format  may  be  used  to  present  a  large  amount  of  information  j 

-  at  one  time.  Formats  are  standardized  so  that  interpretation  is 

uniform  by  all  users.  1 

Formats  of  manually  produced  documentation  are  often  not  standardized 
w  leading  to  problems  and  conflicts  in  interpretation.  Presentations  \ 

of  large  amounts  of  information  on  a  few  pages  is  often  a  problem 
because  of  difficulties  in  completion  and  keeping  the  information 

,  ,  up-to-date. 
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Usefulness 


% 


Each  URA  report  has  been  designed  for  a  particular  purpose,  i.e., 
to  meet  the  system  documentation  needs  of  one  or  more  users. 

In  an  effort  to  maintain  this,  all  information  in  the  reports 
is  presented  in  a  well-structured  manner  and  the  reports  are 
designed  to  be  consistent  in  their  presentations. 

Many  manually  produced  documents  are  done  ad  hoc  with  possibly 
no  serious  considerations  on  how  thedocuments  may  be  used  to  benefit 
the  system  building  process.  In  addition,  the  documentation  is 
often  difficult  to  use  because  of  inconsistencies  in  the  manner 
in  which  information  is  presented  and  seemingly  lack  of  organization. 

Availability 

Documentation  can  be  produced  anytime  (on  request)  once  information 
has  been  stored  in  the  URA  data  base.  This  reduces  the  lag  time 
usually  encountered  in  the  manual  production  of  documentation.  This 
permits  important  decisions  to  be  made  when  the  problem  is  encountered 
rather  than  "next  week,  when  all  the  information  is  available.” 
Physical  production  of  the  reports  is  very  fast  since  this  is 
usually  done  using  a  line  printer  or  terminal. 

Too  often  the  documentation  is  produced  after  the  fact.  This  is 
especially  common  if  the  people  are  very  technically  inclined. 

They  would  rather  sit  at  the  terminal  or  write  program  code  rather 
than  write  documentation.  Therefore,  when  documentation  is  needed, 
little  is  available  or  the  organization  of  the  information  makes  it 
very  difficult  to  use.  Physical  production  of  the  documentation 
then  requires  many  hours  of  manual  labor  behind  pencils  and  type- 
writers  excluding  the  time  and  costs  of  reproducing  the  original. 

(It  is  important  to  note  that  in  most  instances  that  documentation 
produced  in  this  way  is  usually  out-of-date  by  the  time  it 
leaves  the  typewriters.) 

Selectivity 

URA  reports  may  be  generated  containing  all  the  information  known 
about  the  target  system  as  containing  specific  information  about 
one  particular  name  relevant  to  the  description.  This  capability 
allows  the  user  to  see  only  what  is  desired  rather  than  getting 
too  much  or  too  little. 

It  would  be  virtually  impossible  to  incorporate  all  possible 
combination.*?  of  information  in  a  manually  produced  system  in 
an  effort  to  anticipate  any  type  of  request.  Therefore,  the 
description  of  the  target  system  is  presented  in  a  select  number 
of  ways  and  any  information  not  directly  available  must  be 
desired  from  the  available  information  (assuming  it  is  in  some 
way  desirable). 
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Analysis 


•  « 

URA  offers  reports  which  aid  in  checking  completeness  and 
consistency  of  the  problem  statement  as  it  exists  in  the  URA 
data  base.  Many  of  the  reports  present  information  in  a 
manner  which  allows  visual-analysis  of  the  information  to  check 
for  these  qualities.  Other  reports  incorporate  these  checks 
as  part  of  the  information  presented  in  the  report  and  is 
referred  to  as  computer-aided  analysis.  (Visual  analysis  implies 
that  the  checks  are  made  by  the  user  where  computer-aided  analysis 
is  performed  by  the  computer.) 

In  most  forms  of  manually  produced .documentation  the  formats 
used  make  it  difficult  to  check  for  completeness  and  inconsistencies 
in  the  documentation.  Inconsistencies,  in  particular,  go  undetected 
very  easily  as  a  result  of  various  spellings  of  the  same  name  in 
the  description.  Where  one  person  may  know  that  all  the  versions 
of  the  name  refer  to  the  same  thing,  others  may  not. 

Extensions 

In  addition  to  the  standard  reports  available  in  a  particular 
version  of  URA,  the  users  may  write  their  own  programs  which 
generate  reports  to  present  information  particular  to  their 
applications  of  URA.*  The  new  reports  can  be  incorporated  into 
any  future  documentation  packages. 

Manually  produced  documentation  may  incorporate  complex  reports 
involving  a  great  amount  of  computation  and  analysis  in  its 
production,  but  this  requires  the  same  amount  of  computation 
and  anlysis  anytime  the  report  is  to  be  presented.  Rather  than 
consuming  the  analyst’s  time  in  producing  the  report,  it  is 
more  feasible  to  let  the  computer  do  it  (and  in  less  time). 
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The  procedures  necessary  to  write  these  programs  and  which  effectively 
interface  with  the  URA  data  base  will  he  given  in  a  forthcoming  paper. 


3. 


GENERATION  OF  REPORTS 


All  URA  reports  are  produced  by  issuing  commands  to  URA.  All  commands 
available  for  URA  and  the  reports  generated  by  each  are  given  in 
"User  Requirement  Analyzer  Command  Descriptions".*  Descriptions 
of  each  report  and  the  name(s)  of  the  command (s)  used  to  generate  it 
it  given  in  section  5  of  this  paper. 

3. 1  URA  Command  Language  for  Reports 

The  programs  which  are  initiated  by  a  particular  report  command,  retrieve 
information  from  the  URA  data  base  and  output  it  in  some  meaningful 
format.  No  modifications  arc  made  to  the  information  in  the  data  base; 
their  sole  function  is  to  retrieve  the  information  and  display  it  in 
some  manner.  In  the  process  of  collecting  and  displaying  the  information 
analysis  may  be  done  and  the  results  printed  as  part  of  the  report. 

Most  report  commands  have  one  or  more  parameters  that  may  be  used  in 
conjunction  with  the  command  for  one  of  the  following  purposes: 

-  To  specify  data  to  be  used  as  input  to  the  command  (Input  data 
parameters) . 

-  To  specify  how  data  used  as  input  is  to  be  interpretted  (Input 
control  parameters) . 

-  To  specify  what  options  the  user  has  in  generating  the  report 
with  respect  to  content  (Output  option  parameters). 

-  To  specify  what  options  the  user  has  in  generating  the  report  with 
respect  to  format  (Output  format  parameters) . 

The  manner  of  specifying  commands  and  their  parameters  is  given  in 

Part  IV  and  the  manner  of 

using  the  commands  and  parameters  is  given  in  Parts  I  and  II. 


* 
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3.2  Retrieval  of  Information  from  the  URA  Data  Base 


There  are  basically  three  types  of  information  stored  in  a  URA 
data  base: 

1)  Names  and  types  of  objects  defined  by  the  user, 

2)  Comment  entries  (narrative  and  free  format  descriptions  of  objects). 

3)  Connections  among  objects  and  between  an  object  and  comment  entry. 

The  first  type  of  information  is  stored  as  name  records,  the  second  as 
comment  entry  records,  and  the  last  as  NUB  records.* 

Each  URA  report  presents  information  taken  from  one  or  more  of  these 
different  types  of  records.  Table  2  gives  the  information  presented 
by  each  report.  In  addition  each  URA  report  may  also  present  information 
derived  from  the  information  in  one  or  more  of  these  different  types  of 
records . 

The  manner  in  which  the  information  is  presented  differs  from  one  report 
to  another.  The  relationship  between  two  name  records  may  be  either 
implied  by  the  report  format  or  explicitly  defined.  For  example,  the 
FORMATTED  PROBLEM  STATEMENT  would  present  that  "employee-address" 

CONSISTS  of  "street",  "city",  "state"  and  "zip-code".  The  CONTENTS  REPORT, 
on  the  other  hand  would  present  this  in  the  following  format: 

1  employee-address 
2  street 
2  city 
2  state 
2  zip-code 


*  Sec  the  description  of  these  records  as  presented  in  Section  7  of 
Part  I 

for  a  better  understanding  of  the  data  base  structure. 
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Report  Name 

Name 

Records 

Comment 

Entries 

NUB 

Records 

ATTRIBUTE  REPORT 

Yes 

No 

Yes 

CONSISTS  COMPARISON  MATRIX 

Yes 

No 

Yes 

CONSISTS  MATRIX  REPORT 

Yes 

No 

Yes 

CONTENTS  REPORT 

Yes 

No 

Yes 

DATA  BASE  SUMMARY  * 

No 

No 

No 

•DATA  PROCESS  REPORT 

Yes 

No 

Yes 

DICTIONARY  REPORT 

Yes 

Yes 

Yes 

EXTENDED  PICTURE 

Yes 

No 

Yes 

FOMATTED  PROBLEM  STATEMENT 

Yes 

Yes 

Yes 

FREQUENCY  REPORT 

Yes 

No 

Yes 

IDENTIFIER  INFORMATION  REPORT 

Yes 

No 

Yes 

KWIC  INDEX 

Yes 

No 

No 

NAME  GEN 

Yes 

No 

No 

NAME  LIST 

Yes 

No 

No 

PICTURE 

Yes 

No 

Yes 

PROCESS  CHAIN 

Yes 

No 

Yes 

PROCESS  INPUT/OUTPUT 

Yes 

Yes 

Yes 

PUNCHED  COMMENT  ENTRIES 

Yes 

Yes 

Yes 

STRUCTURE 

Yes 

No 

Yes 

Table  2 

Types  of  Information  taken  and  presented  by  URA  Reports 

Therefore,  there  are  three  major  aspects  relative  to  what  is  contained  in 
a  URA  report: 


1)  What  type  of  information  is  presented: 

a)  Names  and  types  of  objects 

b)  Comment  entries 

c)  Connections  among  objects  and  between  an  object  and  comment  entry 

2)  Mow  the  information  is  presented:' 

a)  As  taken  from  the  URA  data  base 

b)  Derived  from  information  in  the  data  base 

3)  How  Rclnti on shins  are  defined: 

a)  explicitly 

b)  implied 


All 

f  rc.Mii 


i  nfonnati  on 
each  of  the¬ 


ir.  this  report  is  "derived" 
different  types  of  records 


from  the  information  taken 
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ATTRIBUTE  REPORT 


Purpose 

This  report  is  intended  to  present  the  system  properties  aspect  of 
the  target  system  description  with  respect  to  the  ATTRIBUTES  defined 
and  used  in  the  description. 

Information  Presented 


The  report  presents,  for  each  ATTRIBUTE  name  used  as  input,  all 
names  in  the  data  base  to  which  the  ATTRIBUTE  applies  and  the  asso¬ 
ciated  ATTRIBUTE-VALUES  for  the  names.  In  effect,  this  presents 
information  given  by  the  ATTRIBUTE  statement. 

Format 


Each  ATTRIBUTE  name  is  numbered,  1*,  2*,  etc.,  as  it  is  encountered 
as  input  and  printed  on  the  report.  Each  name  to  which  a  particular 
ATTRIBUTE  applies  is  also  numbered. 

The  URA  statements: 

INPUT:  time-card; 

ATTRIBUTE  arrival-type  scheduled; 

would  be  presented  as: 

1*  ATTRIBUTE:  arrival-type 

APPLIES  TO:  VALUE: 

1  time-card  scheduled 

in  the  ATTRIBUTE  REPORT  for  the  ATTRIBUTE  arrival-type.  Given  a 
particular  ATTRIBUTE  name,  the  software  generating  the  report  searches 
the  data  base  for  all  names  the  ATTRIBUTE  APPLIES  to  (is  connected 
to)  and  lists  them  under  the  "APPLIES  TO:"  heading  in  the  report  with 
corresponding  ATTRIBUTE-VALUE  under  the  "VALUE:"  heading. 

The  format  for  the  ATTRIBUTE  REPORT  is  considered  to  be  a  list  format. 

Option  and  Alternatives 


The  report  may  be  generated  for  a  single  ATTRIBUTE  name  (via  the  NAME 
parameter)  or  for  a  collection  of  ATTRIBUTE  names  specified  by  the 
user  or  retrieved  via  NAME-GEN. 

Analysis 

Each  name  given  as  input  in  generating  the  report  must  be  checked  that 
it  is  an  ATTRIBUTE  name  before  further  processing  continues.  The  name 
is  then  printed  on  the  rcnort.  If  the  input  name  is  not  an 

ATTRIBUTE  the  message: 

URA093:  .KAfNPAV:  NAME  HAS  NO  USAGES  AS  ATTRIBUTE  l’OR  ANYTHING 

i‘:  printed.  Names  and  corresponding  ATTRIBUTE-VALUES  arc*  then 
retrieved  pair  by  pni.,  an:!  listed  under  tin;:  given  ATI  Si  i  BUTE,  until 
no  more  pairs  are  found  for  the  ATTRIBUTE. 
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The  next  ATTRIBUTE  name  from  the  input  stream  is  taken  (if  there 
is  one)  antf  the  process  repeats. 

Usages 

In  many  applications  of  the  use  of  the  Language  and  Analyzer, 
certain  ATTRIBUTE  names  may  be  designated  as  mandatory  for  a 
description.  For  example,  some  applications  may  require  that 
every  PROCESS  defined  as  part  of  the  description  must  .be  speci¬ 
fied  as  being  either  manual  or  automated  via  the  ATTRIBUTE 
process-type.  Generation  of  the  ATTRIBUTE  REPORT  for  the  name 
process-type  allows  the  analyst  to  determine  if  the  current 
description  is  accurate,  complete  and  consistent  in  this  respect. 


The  report  also  presents  those  names  which  are  logically  related  be¬ 
cause  of  common  ATTRIBUTE- VALUES  among  them.  In  the  previous  example, 
there  were  two  logical  groups,  manual  and  automated.  In  practice 
there  are  usually  several  possible  ATTRIBUTE-VALUES. 

Examples 

Figure  2Q  presents  the  output  resulting  from  generating  the  ATTRIBUTE 
REPORT  using  the  names  produced  by  NAME-GEN  as  input.  The  following 
Analyzer  commands  were  given: 

NAME-GEN  ATTRIBUTE 
PRINT- ATTRIBUTE- VALUES 
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(Continued) 


CONSISTS  COMPARISON  REPORT 


4 

Purpose 


To  present  data  structure  information  for  SET,  INPUT,  OUTPUT, 
ENTITY  and  GROUP  names  given  as  input.  The  report  by-passes  all 
intermediate  levels  of  data  structure  and  only  presents  the  lowest 
level  constituents  of  those  names  given  as  input. 

Information  Presented 


Structure  information  based  on  CONSISTS  statements  in  the  data 
base  can  be  presented  for  SET,  INPUT,  OUTPUT,  ENTITY  and  GROUP  names 
given  as  input.  However,  rather  than  presenting  all  levels  of  the 
data  structure,  only  the  highest  and  lowest  levels  are  present 
ignoring  all  other  levels.  For  example,  the  structure: 

1  hourly-employee-record 
2  employee-name 
3  surname 
3  initial 
3  first-name 

2  employee-identification-number 
2  social-security-number 

might  appear  in  the  CONTENTS  REPORT  which  presents  all  levels 
of  the  data  structure  for  hourly-employee-record.  The  CONSISTS 
COMPARISON  REPORT,  however,  would  present  the  names: 

surname 

initial 

first-name 

employee-identification-number 

social-security-number 

as  the  low  level  components  of  the  data  structure  for  hourly-employee- 
rccord. 

In  addition  to  the  data  structure  relationships  presented,  similarities 
among  data  structures  are  identified  and  summarized  in  the  report. 

Format 


The  first  part  of  the  report  specifies  those  names  given  as  input, 
but  do  not  have  data  structure  relationships  (CONSISTS  statements) , 

Two  lists  are  the  given,  one  giving  all  names  given  as  input  (and  having 
CONSISTS  information) ,  and  the  other  giving  all  the  low  level  con¬ 
stituents  of  those  names  in  the  first  list.  Next  comes  the  BASIC 
CONTENTS  MATRIX  where  each  row  of  the  matrix  represents  one  of  those 
names  given  in  the  list  of  low  level  constituents  and  cacti  column  of 
the  matrix  represents  one  of  the  names  given  in  the  list  of  input  names, 
all  names  in  the  list  and  rows  and  columns  are  numbered  so  that  the 
coj*:*e.vpv»iiuencu  .^.iweon  :i  particular  iuv  or  coin.  »  ;  tiu.*  un.v  that  jI 

represents  is  one  to  one.  A  relationship  between  n  name  represented  by 
a  particular  row  and  a  nan*'  represent ed  by  a  particular  column  is  desig¬ 
nated  by  an  a;  i>  risk  entry  (*)  at  the  intersection  of  the.  row  and  coin:*,  n 
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in  the  matrix.  A  blank  entry  designates  that  no  such  relationship 
exists. 

A  second  matrix  called  the  CONTENTS  SIMILARITY  MATRIX  is  also  generated 
to  present  similarities  in  the  data  structures  (for  those  names  given 
as  input)  as  represented  in  the  BASIC  CONTENTS  MATRIX.  All  infor¬ 
mation  in  the  CONTENTS  SIMILARITY  MATRIX  is  derived  from  information 
presented  in  the  BASIC  CONTENTS  MATRIX.  All  the  names  used  as  input 
are  represented  by  a  column  number  and  row  number  in  the  matrix. 

The  numbers  are  the  same  so  that  any  given  object  is  represented  by 
row  J  and  column  J.)  The  matrix  should  be  read  from  row  to  column 
as  saying:  the  data  object  represented  by  row  I  has  an  integer  number 
of  low  level  constituents  in  common  with  the  data  object  represented  * 

in  column  J.  When  I=J,  the  number  of  low  level  constituents  of  any 
object  in  common  with  itself  is  presented.  This  is,  of  course,  the 
total  number  of  constituents  for  that  given  data  object.  The  final 
section  of  this  report  is  the  CONTENTS  SIMILARITY  ANALYSIS  which  pre¬ 
sents  those  input  names  that  have  identical  lowest  level  constituents 
or  which  are  strict  subsets  (at  the  lowest  level)  of  other  input  names. 

Options  and  Alternatives 

No  options  are  available  to  change  format  or  content  of  the  report. 

Analysis 

Each  name  given  as  input  is  searched  for  in  the  Analyzer  data  base.  If 
the  name  is  not  found,  the  message: 

URA271:  MAINCNC:  NAME  NOT  IN  D.B.-  /  j 

is  printed  and  is  not  represented  in  the  matrices. 

For  each  name  defined  in  the  data  base  with  CONSISTS  information,  its 
components  are  then  found  via  the  CONSISTS  statement.  If  its  components 
have  CONSISTS  information  then  the  procedure  is  continued  until  only 
ELEMENTS  are  encountered  (which  may  not  have  any  sub-conponents)  or  no 
more  CONSISTS  information  can  be  found.  The  lists  of  input  names  and 
low  level  constituents  are  then  printed  on  the  report. 

The  BASIC  CONTENTS  MATRIX  is  then  printed  out  to  illustrate  the  relation¬ 
ships  between  the  names  in  the  two  lists  and  each  relationship  is  desig¬ 
nated  by  an  asterisk. 

The  CONTENTS  SIMILARITY  MATRIX  is  produced  by  counting  the  number  of 
column  entries  in  common  between  any  two  rows  of  the  BASIC  CONTENTS 
MATRIX.  The  diagonal  is  produced  by  counting  the  total  number  of  asterisks 
in  the  BASIC  CONTENTS  MATRIX  for  a  given  row. 

The  CONTENTS  SIMILARITY  SUMMARY  is  produced  by  inspecting  the  numerical  , 

values  in  the  CONTENTS  SIMILARITY  MATRIX.  If  a  particular  number  pre¬ 
sented  in  the  diagonal  occurs  elsewhere  in  the  same  row  of  the  matrix, 
it  menns  that  a  particular  name  (represented  by  the  row)  has  all  of  its 
constituents  in  common  with  another  name.  If  the  other  name  has  the 
same  number  ol  eont'.i.i.uonts:,  i  ‘non  the  data  strut  ter <  .ire  identical.  If 

the  other  name  lias  more  constituents,  then  the  first  name  has  a  data 
structure,  which  is  a  subset  of  the  others. 
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Usage 


« 

One  use  of  the  CONSISTS  COMPARISON  REPORT  is  to  detect  redundant 
or  similar  data  structures.  Its  ability  to  do  this  lies 
in  its  presentation  (ignoring  all  intermediate  levels  of  data 
structure) . 

This  aids  the. analyst  in  detecting  possible  errors  in  the  target 
system  description  and  simplifying  it  should  similarities  in  structures 
occur.  This  is  usually  beneficial  when  the  report  is  generated 
for  all  INPUT,  OUTPUT  and  ENTITY  names  in  the  description  as  input. 

The  report  is  also  beneficial  to  the  system  designer  who  may 
utilize  it  to  optimize  structures  that  the  software  will  eventually 
have  to  access.  Identical  or  similar  structures  for  different  ENTITIES, 
for  example,  may  be  mapped  into  the  same  type  of  storage  structure 
to  reduce  complexity  of  the  software. 

Examples 

Figure  21  presents  the  results  of  generating  the  CONSISTS  COMPARISON 
REPORT  for  all  INPUT  and  OUTPUT  names  in  a  particular  data  base. 

The  following  commands  were  used  to  generate  the  example: 

NAME-GEN  INPUT  OUTPUT 
CONSISTS-COMPARISION 

Note  that  the  two  names  employee-information  and  paysystem-outputs 
are  not  included  in  the  matrices  because  they  do  not  have  CONSISTS 
information. 
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Figure  21  (Continued) 


CONSISTS  MATRIX  REPORT 


Purpose 

To  present  the  data  structure  (as  specified  by  the  CONSISTS  statements), 
either  above  or  below,  each  SET,  INPUT,  OUTPUT,  ENTITY,  GROUP  and/or 
ELEMENT  name  given  as  input  is  involved  in. 

Information  Presented 


For  each  name  used  as  input  (which  must  be  a  SET,  INPUT,  OUTPUT, 
ENTITY,  GROUP  or  ELEMENT)  the  report  presents  names  the  input  name 
CONSISTS  of  (if  the  report  is  generated  with  the  CONSISTS  para¬ 
meter  in  effect)  or  names  the  input  name  is  CONTAINED  in  (if  the 
report  is  generated  with  the  CONTAINED  parameter  in  effect) .  Take 
the  following  structure,  for  example,  and  assume  that  its  description 
exists  in  an  Analyzer  data  base  in  the  form  of  CONSISTS  relationships 
between  the  names: 


(SET)  — 
(ENTITIES)  — 

(GROUPS)  — 
(ELEMENTS)  — 


SET- A 


level  1 


level  2 


level  3 


level  4 


If  the  CONSISTS  MATRIX  REPORT  were  generated  for  all  the  above  GROUP 
names,  GR-A,  GR-B,  GR-C,  GR-D  and  GR-E,  and  the  CONSISTS  parameter 
was  in  effect  when  generating  the  report,  the  ELEMENT  names  EL-A, 
EL-B  and  EL-C  would  be  presented  in  the  report.  The  report  would 
also  designate  GR-A  and  GR-E  as  not  having  any  CONSISTS  information 
available. 

If  the  report  was  generating  with  the  CONTAINED  parameter  in  effect, 
and  the  same  GROUP  names  as  input,  the  ENTITY  names  ENT— A,  ENT-B 
and  ENT-C  would  be  presented  in  the  report. 
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In  essence,  the  CONSISTS  MATRIX  REPORT  presents  one  level  above 
or  one  level  below  designated  starting  points  in  the  data  structures 
described  in  an  Analyzer  data  base. 

The  report  could  not  be  generated  for  SET  names  with  the  CONTAINED 
parameter  in  effect  because  the  Language  does  not  allow  SETS  to  be 
CONTAINED  in  higher  level  structures.  Likewise,  the  report  could  not  be 
generated  for  ELEMENT  names  with  the  CONSISTS  parameter  in  effect 

because  the  Language  does  not  allow  ELEMENTS  to  CONSIST  of  lower  level 
structures. 

The  report  also  presents  statistics  on  the  data  structure  information 
such  as  how  many  low  level  components  a  particular  name  consists  of  or 
how  many  structures  it  is  contained  in. 

Format 


If  the  CONSISTS  parameter  is  used  when  generating  the  report,  any 
names  given  as  input  which  do  not  have  CONSISTS  statements  as  part  of 
their  descriptions  are  flagged  at  the  beginning  of  the  report.  If  the 
CONTAINED  parameter  is  used,  any  names  given  as  input  which  do  not 
have  CONTAINED  statements  as  part  of  their  descriptions  are  flagged. 

Two  lists  of  names  are  then  presented,  one  labeled  ROW  NAMES  and  the 
other  COLUMN  NAMES.  If  the  CONSISTS  parameter  was  used  when  generating 
the  report,  the  names  designated  as  COLUMNS  NAMES  are  those  which 
were  given  as  input.  If  the  CONTAINED  parameter  was  used  when  gener¬ 
ating  the  report,  the  names  designated  as  ROW  NAMES  are  those  which 
were  given  as  input. 

In  any  case,  each  name  under  COLUMNS  NAMES  CONSISTS  of  zero  or  more 
names  under  ROW  NAMES  and  each  name  under  ROW  NAMES  IS  CONTAINED  in 
zero  or  more  names  under  COLUMN  NAMES.  A  matrix  is  then  printed  to 
show  the  relationships  between  the  names  designated  as  ROW  NAMES 
(which  are  represented  by  the  rows  of  the  matrix)  and  the  names  desig¬ 
nated  as  COLUMN  NAMES  (which  are  represented  by  the  columns  of  the 
matrix).  The  rows  and  columns  of  the  matrix  are  numbered  to  corres¬ 
pond  to  the  number  assigned  to  each  name  in  the  list  of  ROW  NAMES  and 
COLUMN  NAMES,  respectively. 

An  asterisk  (*)  entry  at  the  intersection  of  a  particular  row  and 
column  of  the  matrix  designates  that  the  name  represented  by  the  row 
is  CONTAINED  in  the  name  represented  by  the  column. 

Inspection  of  an  entire  row  reveals  all  names  that  a  particular  name 
(represented  by  the  row)  is  CONTAINED  in.  Inspection  of  an  entire 
column  reveals  nil  names  that  a  particular  name  (represented  by  the 
column)  CONSISTS  of. 
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A  summary  section  is  also  included  in  the  report  presenting  for 
each  ROW  NAME: 

The  row  it  was  represented  by  in  the  matrix  (ROW) 

4  * 

Its  name  type  (TYPE) 

The  number  of  *  entries  in  its  row  (or  the  number  of  names 
CONTAINING  it)  (COUNT) 

The  summary  presents  for  each  COLUMN  NAME: 

-  The  column  it  was  represented  by  (COLUMN) 

-  Its  name  type  (TYPE) 

-  The  numb  -  of  *  entries  in *its  column  (or  the  number  of 
names  i,  CONSISTS  of)  (COUNT) 

The  summary  section  for  ROW  and  COLUMN  names  is  ordered  in  decreasing 
order  of  COUNT. 


Options  and  Alternat. iv.es 

The  report  must  be  generated  using  either  the  CONSISTS  or  CONTAINED 
parameter.  If  the  CONSISTS  parameter  is  used,  all  names  given  as 
input  must  be  SET,  INPUT,  OUTPUT,  ENTITY  and/or  GROUP  names.  If  the 
CONTAINED  parameter  is  used  all  names  given  ns  input  must  be  INPUT, 
OUTPUT,  ENTITY,  GROUP  and/or  ELEMENT  names. 

The  report  ray  be  generated  for  a  single  input  name  (via  the  NAME 
parameter)  or  for  a  collection  of  input  names  either  specified  by 
the  user  or  retrieved  via  NAME-GEN. 

Analysis 

Each  name  given  as  input  is  searched  for  in  the  data  base.  If  it  is 
not  found,  the  message: 

URA09S:  CONCOL:  NAME  NOT  IN  D.B.- 


is  printed. 

If  the  CONSISTS  parameter  is  used,  each  name  given  as  input  must  be 
checked  that:  CONSISTS  information  is  available  for  it.  If  no  CONSISTS 
information  is  available,  the  name  is  listed  under  the  message: 

URA315: CONCOL  :  THE  FOLLOWING  DO  NOT  CONSIST  OF  ANYTHING: 

The  components  of  those  input  names  which  do  have  CONSISTS  information 
are  found.  The  1 i '  L  of  all  input  names  and  the  list  of  all  components 
are  then  printed  on  the  report. 


If  the  CONTAINED  parameter  is  used,  each  name  given  ns  input  must  be 
checked  that  CONTAINED  information  is  available  for  it.  If  no  CONTAINED 

iru  ornia t  u*u  i ■/..  *  i  ,  luu  is  Jisteu  u;u;ct  l*u.  : 


UR  A' 


•J-”.  :  FOL1.0W I *\G  ARC  NOT  CONTAINED  TN  ANYTH T NO: 


Those  n.i iinuit  l  input  nan: -a  art:  CONTAINED  in  arc  found.  Thu 

lint  of  ail  .■  <;  and  i:ht*  list  of  namas  they  art:  CONTAINED  i.i 

are  then  printed  on  the  report. 
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A  matrix  is  printed  out  to  illustrate  the  relationships  between  the 
names  in  the  two  lists  and  each  relationship  is  designated  by  an 
asterisk. 

A  summary  is  then  produced  by  counting  the  number  of  asterisks 
appearing  in  each  row  and  each  column  of  the  matrix. 

Usages 


When  a  list  of  ELEMENT  and/or  GROUP  names  are  given  as  input  to  the 
command  producing  the  report  and  the  CONTAINED  parameter  is  specified, 
the  report  aids  the  analyst  by  identifying  which  GROUP  and  ELEMENT 
names  are  not  incorporated  into  higher  level  information  structures. 

It  aids  the  physical  system  designer  by  determining  utilization  of 
ELEMENT  and  GROUP  names  by  the  logical  information  structures  within 
the  target  system  description. 

Generating  the  report  (using  the  CONSISTS  parameter)  for  SET,  INPUT, 
OUTPUT,  ENTITY  and  GROUP  names  determines  which  of  these  have  identical 
structures,  with  respect  to  one  another,  and  which  are  empty,  i.e., 
have  no  CONSISTS  relationships.  This  also  identifies  similarities  in 
the  structures  for  these  types  of  names.  The  analyst  may  then  use  this 
information  to  determine  if  redundant  structures  have  been  defined, 
if  the  description  is  incomplete,  etc. 

Example 

Figure  22  presents  the  CONSISTS  MATRIX  REPORT  generated  with  the  CONSISTS 
parameter  in  effect  and  using  all  INPUT  and  OUTPUT  names  in  a  particular 
data  base  as  input. 

Figure  23  presents  the  report  generated  with  the  CONTAINED  parameter  in 
effect  and  using  all  GROUP  names  in  a  particular  data  base  as  input. 

The  Analyzer  commands  used  to  generate  this  example  were: 

NAME-GEN  GROUP 
CONSISTS-MATRIX  CONTAINED 
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Figure  23  (Continued) 
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Figure  23  (Continued) 


CONTENTS  REPORT 


Purpose 

To  allow  the  user  to  view  entire  data  structures  (all  levels)  described 
in  an  Analyzer  data  base  as  implied  by  the  use  of  the  CONSISTS  statement. 


Information  Presented 


The  CONTENTS  REPORT  presents  all  lower  levels  of  data  structures 
for  SET,  INPUT,  OUTPUT,  ENTITY  and  GROUP  names  used  as  input. 

(Since  ELEMENTS  may  not  have  CONSISTS  information  they  cannot  be 
used  as  input  to  produce  the  report.)  All  names  which  the  input 
names  CONSIST  of  are  designated  as  level  2  names;  the  names  that 
the  level  2  names  CONSIST  of  are  designated  as  level  3  names,  etc. 

The  CONSISTS  statement  allows  network  structures  to  be  constructed 
and  so  any  given  name  may  be  CONTAINED  in  more  than  one  structure, 
and  at  different  levels  in  the  different  structures.  The  types 
of  names  presented  in  the  structures  will  be  INPUTS,  OUTPUTS,  ENTITIES, 
GROUPS  and  ELEMENTS. 

Format 

Each  name  given  as  input  to  the  report  is  identified  by  a  number 
1*,  2*,  etc.  designating  its  position  in  the  list  of  input  names 
and  also  by  the  number  1  designating  it  as  a  level  1  name.  All  names 
that  are  part  of  its  structure  are  numbered  1  through  n  according  to 
its  position  in  the  structure  when  printed  out  and  also  numbered 
according  to  the  name’s  relative  level  in  the  structure.  Each  level 
2,  3  and  so  on  is  indented  to  further  accent  the  idea  of  structure. 

Each  group  of  names  of  a  given  level  number  are  CONTAINED  in  the 
preceeding  name  of  the  next  highest  level  number.  (Level  1  is  the 
highest  level  number.)  For  example,  the  following  URL  description: 

ENTITY  hourly-employee-record ; 

CONS I S  TS  emp 1 oye  e-name , 

employee-identif icat ion-number , 
social-security-number; 

GROUP  employee-name ; 

CONSISTS  surname, 
initial, 
first-name; 


would  appear  as: 

1*  1  hourly-emplovoe-record 

1  2  employee-name 

2  3  surname 

3  3  initial 

4  first-name 

5  2  ompl oyee-identif ica t ion-number 

6  2  soc  i  ai-  sec.iiri  t  y-rniml or 
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in  the  CONTENTS  REPORT  if  the  report  was  generated  for  hourly- 
employee-record.  If  the  report  was  generated  for  employee-name 
the  following  structure  would  appear: 

1*  1  employee-name 

1  2  surname 

2  2  initial 

3  2  first-name 

Options  and  Alternatives 

The  user  may  restrict  the  number  of  levels  of  the  data  structures 
presented  when  a  numerical  value  is  assigned  to  the  LEVELS  parameter. 
For  example,  when  LEVELS-2  is  given  only  the  names  at  levels  one  and 
two  of  the  data  structure  are  presented  in  the  report.  The  report 
normally  prints  out  ALL  levels  of  the  data  structures. 

GROUPS  in  the  structures  which  do  not  CONSIST  of  lower  level  infor¬ 
mation  or  those  UNDEFINED  names  in  the  structure  are  flagged  by  the 
message : 

**N0  CONSISTS  FOR  GROUP  OR  UNDER** 

when  the  NCFLAG  parameter  is  used.  An  INDEX  for  the  report  is  produced 
when  the  INDEX  parameter  is  used. 

The  report  may  be  generated  for  a  single  input  name  (via  the  NAME  para¬ 
meter)  or  for  a  collection  of  input  names  either  specified  by  the  user 
or  retrieved  via  NAME-GEN. 


Analysis 

Each  name  given  as  input  is  searched  for  in  the  data  base.  If  the  name 
is  not  found,  the  message: 

URA065:  MAINCONT:  NAME  NOT  FOUND  IN  D.B.- 


is  printed  and  no  structure  information  is  printed  for  the  name. 

For  each  name  given  as  an  input,  each  name  which  it  CONSISTS  of  is 
designated  as  a  level  2  name  as  it  is  printed  out.  If  this  level  2 
name  CONSISTS  of  any  information,  then  each  name  which  it  CONSISTS 
of  is  designated  as  a  level  3  name  as  it  is  printed  out.  This  process 
continues  until  no  more  CONSISTS  relationships  are  found  or  the  level 
specified  by  the  LEVELS  parameter  is  reached. 


Names  are  printed  out  as  they  are  encountered  in  the  structure. 
Usage 


For  the  analyst,  the  report  presents  information  structures  as  defined 
by  the  use  of  the  CONSISTS  statement  in  a  format  in  which  the  entire 
structure  can  be  seen.  Jt  is  usually  most  beneficial  to  generate  the 

rr..  r  v  TXTiuvr.  ''NTTTY  r . *  in  the  dr:!"i  base 

li.iiur  nil  i.t.ijiM  ml  Uii.l.ili  wu  cunt*  Li  t« .  »  . .  . .  .uu  i  .»  ;;a:  l  )  ,  ,  .  v. 

i:a; 
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should  cou-.ist  of  othei  information  (by 
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e  5  «•  t  •  ; 


For  a  complete  set  of  final  specifications  for  a  particular  target 
system,  th,e  report  may  be  generated  to  present  the  logical  infor¬ 
mation  structures  to  be  handled  by  the  target.  For  this  purpose 
it  is  recommended  that  the  report  be  generated  for  all  SET  names 
with  LEVELS=2  so  that  the  relationships  among  INPUTS,  OUTPUTS  and 
ENTITIES  with  SETS  can  be  presented,  and  generated  for  all  INPUT, 

OUTPUT  and  ENTITY  names  so  that  structures  below  these  names  can 
be  viewed.  The  commands  to  generate  this  information  are: 

NAME-GEN  SET 

CONTENTS  LEVELS=2 

NAME-GEN  INPUT  OUTPUT  ENTITY  ORDER=BYTYPE 

CONTENTS 

the  BYTYPE  option  is  used  so  that  all  names  of  a  particular  name 
type  are  defined  together. 

When  the  volume  of  information  which  will  be  presented  by  the  CONTENTS 
REPORT  is  unknown,  it  is  a  good  practice  to  be  conservative  in  specifying  a 
value  for  LEVELS  rather  than  allow  LEVELS  to  have  the  value  ALL  and 
risk  the  possibility  of  generating  dozens  of  pages  of  output. 

Examples 

Figure  2}y  presents  the  full  data  structure  for  the  name  hourly-employee- 
record.  This  example  was  produced  by  the  following  command: 

CONTENTS  NAME=hourly-employee-record 

’ftlgure  25  presents  the  data  structures  down  to  level  2  for  all  ENTITIES 
defined  in  a  particular  AnAlyzer  data  base.  The  Analyzer  commands 
used  to  generate  this  example  were: 

NAME-GEN  ENTITY 
CONTENTS  LEVELS=2 
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25  (Continued) 


DATA  BASE  SUMMARY 


Purpose  4 

This  report  provides  statistical  information  with  respect  to  the 
usage  of  different  name  types  (e.g.  PROCESSES,  ELEMENTS,  etc*)  and 
can  be  used  as  an  aid  in  estimating  size  of  the  Language  description 
in  an  Analyzer  data  base* 

Information  Presented 

The  report  provides  an  entry  for  each  different  name  type  (PROCESS, 
ELEMENT,  etc.)  defined  in  a  particular  data  base.  For  example,  if  only 
PROCESSES  have  been  defined,  only  a  PROCESS  entry  will  appear  in  the 
report.  For  each  name  type  the  report  entry  presents: 

The  number  of  names  in  the  data  base  of  that  name  type  (COUNT) 

-  The  number  of  these  names  that  have  SYNONYMS  (//U/SYN) 

The  percentage  of  these  names  with  SYNONYMS  (PERCENT) 

-  The  number  of  these  names  that  have  a  DESCRIPTION  (vW/DESC) 

The  percentage  of  these  names  with  a  DESCRIPTION  (PERCENT) 

An  entry  is  also  provided  consisting  of  all  of  the  above  considering  all 
name  types  (**TOTAL**)  in  the  data  base. 

Format 


The  report  presents  six  columns  of  information  as  follows; 

name- type  COUNT  //W/SYN  PERCENT  //W/DESC  PERCENT 

in  a  table  format.  A  row  of  the  table  consists  of  values  '  for  each  of 
the  above  columns.  A  row  is  presented  for  each  name  type  defined  in 
the  data  base  and  the  name  types  are  presented  in  alphabetical  order. 

A  row  is  also  printed  presenting  the  total  for  each  column.  Since  there 
are  a  limited  number  of  name  types,  the  report  always  fits  on  one  page. 


Options  and  Alternatives 

There  are  no  options  available  for  this  report. 


Analysis 


The  software  generating  the  report  looks  at  every  name  in  the  data  base 
and  updates  three  fields  according  to  its  name  type  (COUNT) ,  whether 
or  rot  it  has  a  DESCRIPTION  ( ?‘*’?/nESCl  ,  and  whether  not  it  has  nnv 
SYNONYMS  (#VT/SYN)  .  After  all  names  have  been  looked  at,  percentages 

(P  ’’.c:  *:  l)  i > r  thr1  svrves  vj;h  D’NCRJ PTIONS  and  SV’*V-  N  are  ccr.rrjtrd 
witiiin  eacji  name  Lype. 
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Finally,  totals  are  produced  for  values  retrieved  for  each  table 
heading  and  are  printed. 

If  the  report  is  generated  for  an  empty  data  base,  the  message: 

NO  NAMES  IN  D.B.- 
is  printed. 

Usage 

The  major  benefit  of  this  report  is  to  project  management  personnel 
in  recording  progress  being  made  in  the  target  system  description 
procedure.  Comparing  a  particular  DATA  BASE  SUMMARY  with  previous 
summaries  allows  management  to  see  where  some  of  the  work  effort  has 
been  concentrated.  For  example,  if  52  PROCESSES  are  counted  in  the 
report  compared  to  12  previously,  it  shows  that  the  major  project 
effort  has  been  centered  around  definition  of  PROCESSES. 

General  progress  may  be  evaluated  by  looking  at  the  totals  presented 
for  successive  reports. 

Examples 

Figure  26  presents  the  DATA  BASE  SUMMARY  generated  from  a  small 
description  of  a  target  system. 
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DATA  PROCESS  REPORT 


Purpose 


This  report  shows  the  interaction  between  information  (SETS,  INPUTS, 
OUTPUTS,  ENTITIES,  GROUPS  and  ELEMENTS)  defined  and  the 
PROCESSES  defined  for  the  target  system.  It  also  shows  the  data 
dependencies  among  PROCESSES  as  implied  by  the  Language  descriptions 
of  the  PROCESSES  and  possible  deficiencies  in  the  descriptions  of 
these  PROCESSES. 

Information  Presented  • 


The  information  presented  in  this  report  is  slightly  different 
depending  on  whether  the  DATA  or  PROCESS  parameter  was  used  in 
generating  the  report. 

If  the  DATA  parameter  is  used  in  generating  the  report,  the  names 
used  as  input  must  be  SETS,  INPUTS ,  OUTPUTS,  ENTITIES,  GROUPS  and/or 
ELEMENTS  and  the  report  presents  all  those  PROCESSES  which  manipulate 
the  input  names  via  the  RECEIVED,  USED,  UPDATED,  DERIVED  and  GENERATED 
statements  in  a  particular  Analyzer  data  base. 

If  the  PROCESS  parameter  is  used  in  generating  the  report,  the  names 
used  as  input  must  be  PROCESS  names  and  the  report  presents  all  those 
SET,  INPUT,  OUTPUT,  ENTITY ,  GROUP  and  ELEMENT  names  that  each  input 
PROCESS  name  manipulates  via  the  RECEIVES,  USES,  UPDATES,  DERIVES  and 
GENERATES  statements  in  a  particular  Analyzer  data  base. 

The  interactions  among  data  and  PROCESSES  are  shown  as  a  matrix.  An 
analysis  on  this  matrix  presents  a  summary  describing  the  incomplete 
aspect  of  the  Language  description  with  respect  to  the  information  presented 
in  the  matrix.  For  example,  a  PROCESS  producing  information  without 
using  any  information  would  be  identified  in  this  summary. 

A  second  matrix  presents  the  manner  in  which  the  PROCESSES  (presented 
in  the  first  matrix)  interact,  i.e.,  how  they  depend  on  data  produced 
by  other  PROCESSES.  Again,  the  information  in  this  matrix  is  derived 
from  the  information  in  the  first  matrix. 


Finally,  an  analysis  is  performed  on  this  matrix  and  presented  in  the 
form  of  a  summary.  The  summary  identifies  those  PROCESSES  with  no 
predecessors  (i.e.,  do  not  USE  or  RECEIVE  data  produced  by  other  PROCESSES) 
and  those  with  no  successors  (i.e.,  do  not  DERIVE,  UPDATE  or  GENERATE 
any  data  used  by  other  PROCESSES). 


The  two  summaries  and  the  second  matrix  are 
information  presented  in  the  first  matrix, 
are  designated  incomplete  in  the  report,  may 
where  in  the  description  in  the  data  base. 
':ereri nt  i  on  was  in  the  data  base: 


all  produced  based  on  the 
Therefore,  items  which 
actually  be  resolved  else- 
For  example,  if  the  follow- 
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PROCESS:  payroll-processing; 

USES :  employee-inf ormation; 

'w  DERIVES:  pay system-outputs ; 

and  the  DATA  PROCESS  REPORT  was  produced  for  the  name  employee- 
information,  the  PROCESS  payroll-processing  would  be  presented  since 
it  USES  it.  The  report  would  then  identify  payroll-processing  as 
USING  data  but  not  UPDATING  or  DERIVING  anything  though  elsewhere  in  the 
description  it  does.  For  this  reason,  it  is  important  to  recognize 
that  the  comments  in  the  report  are  made  with  respect  to  the  infor¬ 
mation  in  the  first  matrix  rather  than  the  entire  description  as  it 
exists  in  the  data  base. 

Format 


Two  lists  of  names  are  first  presented,  one  labeled  ROW  NAMES  and  the 
other  COLUMN  NAMES.  If  the  DATA  parameter  was  used  in  generating  the 
report,  the  names  designated  as  ROW  NAMES  are  those  which  were  given 
as  input.  If  the  PROCESS  parameter  was  used  in  generating  the  report 
the  names  designated  as  COLUMN  NAMES  are  those  which  were  given  as 
input . 

In  any  case,  each  name  under  COLUMN  NAMES  in  some  way  (RECEIVES,  USES, 
etc.)  interacts  with  zero  or  more  names  given  under  ROW  NAMES  and  each 
name  under  ROW  NAMES  is  manipulated  (USED,  DERIVED,  etc.)  by  zero  or 
more,  PROCESS  names  given  under  COLUMN  NAMES . 

The  DATA  PROCESS  INTERACTION  MATRIX  is  then  printed  out  to  show  the 
relationships  between  the  names  designated  as  ROW  NAMES  (which  are 
represented  by  the  rows  of  the  matrix)  and  the  names  designated  as 
COLUMN  NAMES  (which  are  represented  by  the  columns  of  the  matrix) . 

The  rows  and  columns  of  the  matrix  are  numbered  to  correspond  to  the 
number  assigned  to  each  name  in  the  list  of  ROW  NAMES  and  COLUMN  NAMES, 
respectively. 

An  entry  (R,  U,  D,  A,  F,  1  or  2)  at  the  intersection  of  a  particular 
row  and  column  of  the  matrix  designates  that  the  name  represented  by 
the  row  is  manipulated  in  some  way  (as  defined  by  the  meaning  of  the 
entry)  by  the  name  represented  by  the  column.  A  legend  is  provided  as 
part  of  the  report  that  defines  the  meaning  of  each  possible  entry. 

This  legend  is  shown  below  for  purposes  of  clarification. 

(i,  1)  value  meaning _ 

R  Row  i  is  received  or  used  by  column  j  (input) 

U  Row  i  is  updated  by  column  j 

D  Row  i  is  derived  or  generated  by  column  j  (output) 

A  Row  i  is  input  to,  updated  by,  and  output  of 

column  j  (all) 

F  Row  i  is  input  to  and  output  of  column  j  (flow) 

1  Row  :i  is  input  to  and  updated  by  column  j 

2  Row  i  is  updated  by  and  output  of  column  j 
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A  summary  section  called  the  DATA  PROCESS  INTERACTION  MATRIX  ANALYSIS 
is  then  presented  specifying  those  Inconsistencies  found  in  analysis 
of  the  DATA  PROCESS  INTERACTION  MATRIX.  Inconsistencies  for  ROW 
NAMES  and  COLUMN  NAMES  are  handled  separately.  Inconsistencies  found 
for  ROW  NAMES  are  presented  under  the  DATA  heading  and  are  of  the 
following  format; 

row  name  (name-type)  (row  number)  inconsistency  message 

Inconsistencies  found  for  COLUMN  NAMES  are  presented  under  the  PROCESS_ 
heading  and  are  of  the  following  format: 

column  name  (row  number)  inconsistency  message  * 

No  name- type  is  necessary  because  all  names  under  COLUMN  NAMES  are  PROCESSES. 

A  second  matrix,  the  PROCESS  INTERACTION  MATRIX,  is  printed  to  show 
relationships  implied  between  PROCESSES  in  the  DATA  PROCESS  INTERACTION 
MATRIX.  In  this  matrix  both  the  rows  and  columns  represent  those 
PROCESS  names  listed  under  COLUMN  NAMES  and  the  rows  and  columns  are 
numbered  to  correspond  to  the  appropriate  name  in  COLUMN  NAMES. 

An  asterisk  (*)  entry  at  the  intersection  of  a  particular  row  and  column 
of  the  matrix  designates  that  the  PROCESS  represented  by  the  row  DERIVES 
or  UPDATES  some  information  which  is  USED  by  the  PROCESS  represented  by 
the  column. 

A  summary  section  called  the  PROCESS  INTERACTION  MATRIX  ANALYSIS  then 
presents  observations  on  the  information  in  the  PROCESS  INTERACTION 
MATRIX.  These  observations  are  presented  in  the  following  format: 

process  name  (row  or  column  number)  observation 

An  observation  is  given  for  each  PROCESS  which  does  not  use  information 
produced  by  any  of  the  other  PROCESSES,  or  does  not  produce  information 
used  by  any  of  the  other  PROCESSES. 

Options  and  Alternatives 

The  report  must  be  generated  using  either  the  DATA  or  PROCESS  parameter. 

If  the  DATA  parameter  is  used,  all  names  given  as  input  must  be  SET, 

INPUT,  OUTPUT,  ENTITY,  GROUP  and/or  ELEMENT  names.  If  the  PROCESS 
parameter  is  used,  all  names  given  as  input  must  be  PROCESS  names. 

Various  sections  of  the  report  can  be  printed  or  left  out  depending 
on  the  parameters  used  when  generating  it.  These  parameters  and  their 
effects. are  presented  below: 


1.  DPMAT  -  the  DATA  PROCESS  INTERACTION  MATRIX  is  included  in 

the  report 


NODPMA.T 


the  matrix  is  not  printed 


NODI 


llu.-  anajy.'Ma  is  not  prini«*u 
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3.  PMAT 


the  PROCESS  INTERACTION  MATRIX  is  included  in 
the  report 


NOPMAT 


the  matrix  is  not  printed 


4.  PANL 


the  PROCESS  INTERACTION  ANALYSIS  is  included 
in  the  report 


NOPAHL 


the  analysis  is  not  printed 


The  report  may  be  generated  for  a  single  input  name  (via  the  name 
parameter)  or  for  a  collection  of  input  names  either  specified  by  the 
user  or  retrieved  via  NAME-GEN. 


Analysis 


Each  name  given  as  input  is  searched  for  in  the  data  base.  If  it  is 
not  found,  the  message: 

URA143 JMAINDP:  NAME  NOT  IN  D.B.- 

is  printed.  If  the  name  is  found  and  the  DATA  parameter  is  used,  the 
name  is  checked  that  it  is  a  SET,  INPUT,  OUTPUT,  ENTITY,  GROUP  or 
ELEMENT  name.  If  it  is  not,  the  message: 

URA154 :MATNDP :  INVALID  INPUT  NAME  TYPE 

is  printed  and  the  name  is  not  included  in  the  matrix. 

If  the  DATA  parameter  is  used,  all  PROCESS  names  which  RECEIVE,  USE, 
UPDATE,  DERIVE  and/or  GENERATE  each  input  name  are  found.  The  list  of 
all  input  names  and  the  list  of  all  PROCESS  names  found  are  then  printed 
on  the  report. 

If  the  PROCESS  parameter  is  used,  all  SET,  INPUT,  OUTPUT,  ENTITY,  GROUP 
and/or  ELEMENT  names  which  interact  with  each  input  name  are  found.  The 
list  of  all  input  names  and  the  list  of  all  SET,  INPUT,  OUTPUT,  ENTITY, 
GROUP  and  ELEMENT  names  found  are  then  printed  on  the  report. 

The  DATA  PROCESS  INTERACTION  MATRIX  is  then  printed  with  the  appropriate 
value  (R,  U,  D,  A,  F,  1  or  2)  designating  a  relationship  between  a  column 
name  and  row  name. 

The  matrix  is  then  analyzed  and  inconsistency  messages  are  printed  as 
data  diagnostics  (for  row  names  representing  SET,  INPUT,  OUTPUT,  ENTITY, 
GROUP  and/or  ELEMENT  names)  and  process  diagnostics  (for  column  names 
representing  PROCESS  names). 


These  diagnostics  are  presented  below  categorized  by  the  name  types  to 
which  they  may  apply. 


I.  DATA  DIAGNOSTICS  (ROV7S) 


1.  INPUT  names 

4 

-  not  RECEIVED  by  any  PROCESS 

If  no  PROCESS  names  RECEIVE  the  INPUT  name  of  interest, 
this  diagnostic  is  printed.  If  at  least  one  PROCESS  RECEIVES 
the  INPUT  name,  the  message  is  not  printed. 

-  not  USED  by  any  PROCESS 

If  no  PROCESS  USES  the  INPUT  name  of  interest,  this  diagnostic 
is  printed.  If  at  least  one  PROCESSES  USES  the  INPUT  name, 
the  message  is  not  printed. 

2.  OUTPUT  names 

-  hot  GENERATED  by  any  PROCESS 

If  no  PROCESS  names  GENERATE  the  OUTPUT  name  of  interest,  this 
diagnostic  is  printed.  If  at  least  one  PROCESS  GENERATES 
the  OUTPUT  name,  the  message  is  not  printed. 


-  not  DERIVED  by  any  PROCESS 

If  no  PROCESS  names  DERIVE  the  OUTPUT  name  of  interest,  this 
diagnostic  is  printed.  If  at  least  one  PROCESS  DERIVES  the 
OUTPUT  name,  the  message  is  not  printed. 

3.  ENTITY  or  SET  names 

-  not  DERIVED  by  any  PROCESS 

If  no  PROCESS  names  DERIVE  the  ENTITY  or  SET  name  of  interest, 
this  diagnostic  is  printed.  If  at  least  one  PROCESS  DERIVES 
the  name,  the  message  is  not  printed. 

-  DERIVED  but  not  USED  by  any  PROCESS 

If  at  least  one  PROCESS  name  DERIVES  and  no  PROCESS  names  USE 
the  ENTITY  or  SET  name  of  interest,  then  this  diagnostic  is 
printed.  There  are  3  conditions  that  will  cause  this  message 
not  to  be  printed: 

i)  the  name  is  not  DERIVED  by  any  PROCESS 
ii)  the  name  is  USED  by  at  least  one  PROCESS 
jii )  both  1  and  2 
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UPDATED  but  not  USED  by  any  PROCESS 


IJf  at  least  one  PROCESS  UPDATES  and  no  PROCESS  USES 
'w  'the  ENTITY  or  SET  name  of  interest,  this  diagnostic 

is  printed.  There  are  3  conditions  that  will  cause  this 
message  not  to  be  printed: 

i)  the  name  is  not  UPDATED  by  any  PROCESS 

ii)  the  name  is  USED  by  at  least  one  PROCESS 

iii)  both  1  and  2 

4.  GROUP  or  ELEMENT 

-  not  DERIVED,  UPDATED,  or  USED  by  any  PROCESS 

If  no  PROCESS  names  DERIVE,  UPDATE  or  USE  the  GROUP  or 
ELEMENT  name  of  interest,  this  diagnostic  is  printed. 

There  are  several  conditions  that  will  cause  this  message 
not  to  be  printed: 

i)  at  least  one  PROCESS  DERIVES  the  name 

ii)  at  least  one  PROCESS  UPDATES  the  name 

iii)  at  least  one  PROCESS  USES  the  name 

w,  iv)  all  3  or  any  combination  of  the  above 

NOTE:  it  is  only  necessary  that  one  of  the  first 

3  conditions  is  satisfied  for  the  message 
not  to  be  printed. 

II.  PROCESS  DIAGNOSTICS  (COLUMNS) 

-  does  not  interact  with  any  data 

If  the  PROCESS  of  interest  does  not  interact  with  any  SET,  INPUT, 
OUTPUT,  ENTITY,  GROUP  or  ELEMENT  names,  this  diagnostic  is  printed. 
If  at  least  one  name  interacts  with  this  PROCESS,  this  message 
is  not  printed. 


-  USES  data,  but  does  not  DERIVE  or  UPDATE  anything 

If  the  PROCESS  of  interest  USES  at  least  one  SET,  INPUT,  ENTITY, 
GROUP  or  ELEMENT  name  and  does  not  DERIVE  or  UPDATE  any, 
this  diagnostic  is  printed.  There  are  several  conditions 
where  this  message  will  not  be  printed: 
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i)  the  PROCESS  does  not  USE  any  SET,  INPUT,  ENTITY,  GROUP 
or  ELEMENT 

ii)  the  PROCESS  DERIVES  at  least  one  SET,  OUTPUT,  ENTITY,  GROUP 
or  ELEMENT 

ill)  the  PROCESS  UPDATES  at  least  one  SET,  ENTITY,  GROUP  or 
ELEMENT 

iv)  all  3  or  any  combination  of  the  above 


-  DERIVES  something  but  does  not  USE  anything 

If  the  PROCESS  of  interest  DERIVES  at  least  one  SET,  ENTITY, 

GROUP  or  ELEMENT  and  does  not  USE  any,  this  diagnostic  is 
printed.  There  are  3  conditions  where  this  message  will  not 
be  printed: 

i)  the  PROCESS  does  not  DERIVE  any  SET,  OUTPUT,  ENTITY,  GROUP 
or  ELEMENT 

ii)  the  PROCESS  USES  at  least  one  SET,  INPUT,  ENTITY,  GROUP 
or  ELEMENT 

iii)  both  1  and  2 

-  UPDATES  something  but  does  not  USE  anything 

If  the  PROCESS  of  interest  UPDATES  at  least  one  SET,  ENTITY, 

GROUP  or  ELEMENT  and  does  not  USE  any,  this  diagnostic  is  printed. 
There  are  3  conditions  where  this  message  will  not  be  printed: 

i)  the  PROCESS  does  not  UPDATE  any  SET,  ENTITY,  GROUP  or 
ELEMENT 

ii)  the  PROCESS  USES  at  least  one  SET,  INPUT,  ENTITY,  GROUP 
or  ELEMENT 

iii)  both  1  and  2 

The  PROCESS  INTERACTION  MATRIX  is  then  produced  using  the  data  in  the 
first  matrix.  The  entries  in  a  given  column  (representing  a  PROCESS 
name)  of  the  DATA  PROCESS  INTERACTION  MATRIX  are  compared  with  the 
entries  for  each  other  column.  If  an  entry  in  the  given  column  desig¬ 
nates  that  the  PROCESS  USES  information  which  is  DERIVED  or  UPDATED  by 
the  column  being  compared  with,  an  *  entry  is  made  in  the  PROCESS 
INTERACTION  matrix  at  the  coJumn  or  row,  respectively,  representing 
these  two  PROCESS  names.  The.  matrix  is  then  analyzed  and  observations 
are  produced  from  this  analysis.  These  observations  are  presented 
be! ow. 
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no  interaction  with  other  PROCESSES 


If  a  PROCESS  does  not  USE  an  object  and  also  does  not  DERIVE 
or  UPDATE  an  object,  this  diagnostic  is  printed.  There  are  3 
conditions  that  will  cause  this  message  not  to  be  printed: 


i) 

the  PROCESS  USES  at  least  one  SET,  INPUT,  ENTITY,  GROUP 
or  ELEMENT 

* 

ii) 

the  PROCESS  UPDATES  or  DERIVES  a  SET,  OUTPUT,  ENTITY, 

GROUP  or  ELEMENT 

iii) 

both  1  and  2 

* 

-  no 

predecessors  for  this  PROCESS 

If  the  PROCESS  of  interest  does  not  USE  any  objects  but  DERIVES 
or  UPDATES  at  least  one  object,  this  diagnostic  is  printed. 

The  3  conditions  that  will  cause  this  message  not  to  be  printed 
are: 

i)  the  PROCESS  USES  at  least  one  SET,  INPUT,  ENTITY,  GROUP 
or  ELEMENT 

ii)  the  PROCESS  does  not  DERIVE  or  UPDATE  any  SETS,  OUTPUTS, 
ENTITIES,  GROUPS  or  ELEMENTS 

iii)  both  1  and  2 

-  no  successors  for  this  PROCESS 

If  the  PROCESS  of  Interest  USES  at  least  one  object  but  does 
not  DERIVE  or  UPDATE  any  object,  this  diagnostic  is  printed.  The 
3  conditions  that  will  cause  this  message  not  to  be  printed  are: 

i)  the  PROCESS  does  not  USE  any  SETS,  INPUTS,  ENTITIES,  GROUPS 
or  ELEMENTS 

ii)  the  PROCESS  DERIVES  or  UPDATES  at  least  one  SET,  OUTPUT, 
ENTITY,  GROUP  or  ELEMENT 

iii)  both  1  and  2 

Usage 

When  the  report  is  generated  using  the  DATA  parameter,  it  aids  in  pre¬ 
senting  the  utilization  of  SET,  INPUT,  OUTPUT,  ENTITY,  GROUP  and 
ELEMENT  names  defined.  This  aids  in  identifying  which  names  are  not 
being  utilized.  For  those  names  which  are  being  utilized,  it  presents 
all  the  PROCESS  names  which  utilize  them. 

When  the  report  is  generated  using  the  PROCESS  parameter,  it  presents 

all  the  data  required  for  each  particular  PROCESS.  It  also  aids  in 

iuciiLii  yin^  i  nmaeo  v.n.tch  cio  nut  internet,  ui  an',  uw*. 

consistently  tiffined  with  respect  to  the  manner  in  which  they  use  dntn. 
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The  PROCESS  INTERACTION  MATRIX  may  be  used  by  designers  to  plan  out. 
the  logic  of  the  target  system  because  it  presents  the  data  dependencies 
among  the  PROCESSES  defined. 

The  following  completeness  checks  can  be  made  for  a  target  system 
description  based  on  information  presented  in  the  report: 

-  All  INPUTS  RECEIVED  by  some  PROCESS 

-  All  INPUTS  USED  by  some  PROCESS 

-  All  OUTPUTS  GENERATED  by  some  PROCESS 

-  All  OUTPUTS  DERIVED  by  some  PROCESS 

-  All  ENTITIES  and  SETS  DERIVED  by  some  PROCESS 

-  All  ENTITIES  and  SETS  DERIVED  and  USED  by  some  PROCESS 

-  All  ENTITIES  and  SETS  are  UPDATED  and  USED  by  some  PROCESS 

-  All  GROUPS  and  ELEMENTS  are  DERIVED  or  UPDATED  or  USED  by  some 
PROCESS 

-  All  PROCESSES  USE  data  and  DERIVE  or  UPDATE  data 

-  All  PROCESSES  which  DERIVE  data  also  USE  data 

-  All  PROCESSES  which  UPDATE  data  also  USE  data 

-  All  PROCESSES  interact  with  data  in  some  way 

The  report  may  also  be  used  to  aid  in  determining  if  the  description 
of  the  target  system  v?as  specified  consistently  with  respect  to  the 
use  of  language  statements.  In  particular,  it  determines: 

-  whether  or  not  the  use  of  RECEIVES  and  GENERATES  statements 
in  describing  the  system  flow  aspect  of  the  system  is  con¬ 
sistent  . 

-  whether  or  not  the  use  of  USES,  UPDATES  and  DERIVES  statement 
in  describing  the  data  derivation  aspect  of  the  system  is 
consistent. 

Examples 

Figure  27  presents  the  DATA  PROCESS  REPORT  generated  for  all  INPUT, 
OUTPUT  and  ENTITY  names  defined  for  a  particular  target  system  descrip¬ 
tion.  This  example  was  produced  using  the  Analyzer  commands: 


NAME-GEN  INPUT  OUTPUT  ENTITY 


Figure  2 8  presents  the  report  generated  for  low  level  PROCESSES 
defined  in  the  description.  These  PROCESSES  were  identified 
by  the  KEYWORD  "terminal"  and  the  report  was  produced  by  the 
follov/ing  Analyzer  commands: 

NAME-GEN  PROCESS  KEY= terminal 
DATA-PROCESS  PROCESS 
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DICTIONARY  REPORT 


Purpose 

This  report  presents  definitions  attached  to  names  used  in  a  Language 
description  and  is  intended  as  an  aid  in  communication  among 
persons  interested  in  the  description. 

Information  Presented 


This  report  prints  out  the  following  information  about  each  name 
used  as  input  when  generating  the  report  and  the  appropriate  para¬ 
meters  are  used: 

-  Name  type  of  the  name 

-  DESCRIPTION  comment  entry  for  the  name 

-  SYNONYMS  associated  with  the  name 

-  RESPONSIBLE  PROBLEM  DEFINER  for  the  name's  description 

-  REWORDS  associated  with  the  name 

All  of  the  above  information  is  readily  available  from  the  contents 
of  the  data  base. 

Format 


A  dictionary  entry  is  presented  for  each  name  given  as  input  to  the 
software  producing  the  report.  The  first  line  of  each  entry  consists 
of : 


-  A  number  designating  the  order  the  name  was  read  from  the 
input  (and  consequently  presented  in  the  report) 

-  The  name  the  entry  is  for 

-  The  name  type  of  the  name 

The  DESCRIPTION,  SYNONYM,  KEYWORDS  and  RESPONSIBLE-PROBLEM-DEFINER 
statements  for  each  name  are  presented  in  the  following  format  after 
the  first  line  of  the  entry: 


DESCRIPTION: 

DESCRIPTION  comment  entry ^ 
SYNONYMS:  |_all  SYNONYMS  for  the  name 


[■ 


Km.f 


OPTE":  f  r:  1 


1  for  f-}*  m  r. 


listed  two  per  line 
1-Jr.rM  oer  lino 


] 


■  r  *  t  ' :  ; 


!') 


*1 


Sp.  tCirr*  he  i  uOOn  d  \  <  i  >  oil 


uiiliie?;  i  mv  he  modified  by  the  NUM-SPAC  ’•* 
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Options  and  Alternatives 


The  numbed  of  lines  skipped  between  dictionary  entries  is  specified  by 
the  NUM-SPACE  parameter,  by  default,  3  lines  are  skipped  but  NUM-SPACE 
may  take  any  value  0  through  10. 

The  different  types  of  information  presented  in  a  report  entry  can  be 
included  in  or  left  out  of  the  report  depending  on  the  parameters  used 
when  generating  it.  Each  parameter  and  its  effect  is  presented 
below: 


1. 

DESCRIPTION 

the  DESCRIPTION  comment  entry  for  each 
name  is  printed 

NODESCRIPTION 

-• 

DESCRIPTION  comment  entries  are  not 
printed 

2. 

KEYWORDS 

- 

all  KEYWORDS  associated  to  each  name  is 
printed  out 

NOKEYWORDS 

- 

KEYWORDS  are  not  printed 

3. 

RES  PONS  IBI.E-PD 

- 

the  RESP0NSIBLE--PR03LEM-DEFINER  for  each 
name  is  printed 

NORESPONSJ.BLE-PD 

- 

RESPONSIBLE-PROBLEM-DEFINERS  are  not  printed 

4. 

SYNONYMS 

- 

all  SYNONYMS  associated  to  each  name 
are  printed  out 

NOSYNONYMS 

- 

SYNONYMS  are  not  printed 

An 

INDEX  for  the  report 

is 

provided  when  the  INDEX  parameter  is  used. 

Analysis 

For  each  name  given  as  input,  the  software  finds  the  name  in  the  data 
base.  If  the  name  cannot  be  found,  the  message: 

URA064:  MAINDICT:  NAME  NOT  FOUND  IN  D.B.  - 

is  printed..  If  the  name  is  found,  the  information  specified  by  the 
parameters  for  the  command  is  retrieved  if  available  for  the  name. 

Us_age 

The  report  is  a  valuable  aid  to  analysts  in  maintaining  definitions  for 
names  in  the  data  base  and  as  a  toe]  for  communicating  with  users  of 
the  target  system.  The  DESCRIPTIONS  for  each  name  may  be  okayed  or 
disapproved  by  the  users  with  respect  to  what  the  users  require  of  the 
target  system.  As  DESCRIPTIONS  are  modified,  the  analyst,  can  add,  delete 
or  modify  other  statements  to  correspond  to  the  II3SCRIETI0NS. 

If  convention:;  are  imposed  on  the  1;v»;ii;igc  doner  i  pi  i  on  required  for 
particular  types  of  nrrm.v  ,  an  effective  data  dictionary  can  he  form'd, 

1*0.  i  *  ;.n;p  I  o  ,  {;,  .  i  (ji:  i  r  :  .iv  certain  N  V.  ...  v  )S  In  ...  .  :  to  (.P'SV 
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ELEMENT  names  and  that  each  GROUP  and  ELEMENT  name  have  a  DESCRIPTION, 
the  DICTIONARY  REPORT  would  be  a  good  reference  for  anyone  interested 
in  the  data  described  in  the  target  system. 

Examples 

Figura  29  presents  the  DICTIONARY  REPORT  for  a  single  PROCESS  name. 
This  example  was  produced  by  the  command: 

DICTIONARY  NAME-payr oil-processing 

Figure  30  presents  the  report  for  several  PROCESS  names  which  have  the 
KEYWORD  'independent".  This  example  was  produced  by  the  following 
Analyzer  commands : 

NAME-GEN  PROCESS  KEY=independent 
DICTIONARY 
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Figure  30  (Continued) 


Purpose 


To  present  in  graphical  format,  for  each  name  input,  a  network  of 
names  related  to  it  by  structure  or  by  data  flow. 

Information  Presented 


Names  input  to  the  report  may  have  any  of  the  following  types: 

ELEMENT 

ENTITY 

GROUP 

INPUT 

INTERFACE 

OUTPUT 

PROCESS 

SET 

Starting  with  each  input  name,  one  of  four  pictures  will  be  obtained. 
These  are  referred  to  as  structure  downward,  structure  upward,  data¬ 
flow  forward,  and  data-flow  backward. 

For  each  name  used  as  input,  the  report  presents  all  successors  to 
that  name,  where  successors  are  found  using  the  relationships  listed 
in  the  appropriate  column  of  either  Table  3  °r  Table  4 .  For  each  of 
these  new  names,  the  report  presents  all  of  its  successors,  finding 
them  in  a  similar  manner.  This  network  continues  until  the  desired 
number  of  relationships  has  been  traced,  a  loop  is  encountered,  or 
no  more  relationships  are  found. 


Name  Type 

Relationships  Displayed 
Structure  Downward 

Relationships  Displayed 
Structure  Upward 

ELEMENT 

CONTAINED 

ENTITY 

CONSISTS 

CONTAINED 

GROUP 

CONSISTS 

CONTAINED 

INPUT 

SUBPARTS 

PART 

CONSISTS 

CONTAINED 

INTERFACE 

SUBPARTS 

PART 

OUTPUT 

SUBPARTS 

PART 

CONSISTS 

CONTAINED 

PROCESS 

SUBPARTS 

PART 

UTILIZES 

UTILIZED 

SET 

SUBSETS 

SUBSET 

CONSISTS 

Table  ) 

Structure  Relationships  Displayed  in 
Extended  Picture  Report 
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Name  Type 

Relationships  Displayed 
Data-Flow  Forward 

Relationships  Displayed 
Data-Flow  Backward 

ELEMENT 

USED 

USED  TO  DERIVE 

USED  TO  UPDATE 

DERIVED 

UPDATED 

ENTITY 

USED 

USED  TO  DERIVE 

USED  TO  UPDATE 

DERIVED 

UPDATED 

GROUP 

USED 

USED  TO  DERIVE 

USED  TO  UPDATE 

DERIVED 

UPDATED 

INPUT 

RECEIVED 

USED 

USED  TO  DERIVE 

USED  TO  UPDATE 

GENERATED 

INTERFACE 

GENERATES 

RECEIVES 

OUTPUT 

RECEIVED 

GENERATED 

DERIVED 

PROCESS 

GENERATES 

DERIVES 

UPDATES 

RECEIVES 

USES 

USES  TO  DERIVE 

USES  TO  UPDATE 

SET 

USED 

USED  TO  DERIVE 

USED  TO  UPDATE 

DERIVED 

UPDATED 

Table  4 

Data  Flow  Relationships  Displayed  in 
Extended  Picture  Report 
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Format 


Each  name  which  appears  on  the  output  is  shown  within  a  box. 

The  top  line  of  the  box  indicates  the  name  type,  while  the  bottom 
line  shows  the  relationship  with  the  name's  predecessor.  Boxes 
containing  related  names  are  linked  by  dotted  lines. 

If  a  name  joins  two  or  more  chains  (strings  of  related  names)  into  * 

a  loop  or  loops,  every  appearance  of  that  name  after  the  first 
will  be  linked  to  a  box  containing  the  message,  "LOOPS  TO  PREVIOUS 
ENTRY." 

# 

Output  is  continued  across  page  boundaries.  If  the  right  edge  of 
one  page  continues  to  the  left  edge  of  a  second,  the  rightmost 
column  of  boxes  on  the  first  page  will  be  repeated  as  the  leftmost 
column  of  boxes  on  the  second  page,  in  order  to  facilitate  match¬ 
ing  of  edges.  Similarly,  if  the  bottom  edge  of  one  page  continues 
to  the  top  edge  of  a  second,  the  bottom  row  of  boxes  on  the  first 
page  will  be  repeated  as  the  top  row  of  boxes  on  the  second  page. 

Options  and  Alternatives 

The  report  may  be  generated  for  a  single  name  (via  the  NAME  para¬ 
meter)  or  for  a  collection  of  names,  either  input  by  the  user  or 
obtained  by  use  of  NAME-GEN. 

The  type  of  picture  to  be  produced  is  selected  by  specifying  one 
of  the  following  parameter  pairs: 

STRUCTURE  DOWNWARD 
STRUCTURE  UPWARD 
DATA-FLOW  FORWARD 
DATA-FLOW  BACKWARD 

The  number  of  columns  and  rows  used  on  the  page  may  be  decreased  from 
their  default  values  of  119  and  39,  respectively,  via  the  COLUMNS 
and  ROWS  parameters.  The  minimum  acceptable  values  for  COLUMNS  and 
ROWS  are  38  and  14,  respectively. 

The  number  of  boxes  arranged  horizontally  or  vertically  on  a  page 

may  be  decreased  from  the  defaults ,  which  are  the  maximum  numbers  that 

will  fit  in  each  direction  (depending  on  COLUMNS  and  ROWS),  in  order 

to  make  the  output  less  cluttered.  The  parameters  which  can  be  used 

to  do  this  are  HORIZONTAL- BOXES  and  VERTICAL-BOXES.  Their  maximum 

values  (for  C0LUMNS=s119  and  ROWS=39)  are  6.  Due  to  the  scheme  for  4 

continuing  pages,  their  minimum  values  are  2. 

The  number  of  connections  to  be  traced,  starting  at  the  given  name, 
may  be  set  at  any  positive  value  via  the  LINKS  parameter.  The  same 
LINKS  value  is  used  for  all  names  input  when  the  FILE  parameter  is 
used . 

km  index,  containing  each  name  used  on  the  report  and  the  page(s)3 
on  which  it  appears,  may  be  obtained  by  specifying  the  INDEX  parameter. 
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Analysis 


Each  name  given  as  input  is  first  checked  to  see  that  it  is  in  the 
data  base  and  that  it  has  one  of  the  legal  types  (ELEMENT,  ENTITY, 
GROUP,  INPUT,  INTERFACE,  OUTPUT,  PROCESS,  or  SET).  If  the  name 
is  not  in  the  data  base,  the  message 

URA370:  MAINEP:  NAME  NOT  FOUND  IN  DATA  BASE 

will  be  given.  If  the  name  has  a  type  which  is  not  in  the  list 
above,  the  user  will  receive  the  message 

URA371:  EPSUCC:  NAME  NOT  ACCEPTABLE  TYPE  FOR  EP  REPORT. 

If  the  name  passes  these  two  tests,  it  is  placed  in  a  data  structure 
which  will  later  be  used  for  output.  The  name  is  then  used  to 
generate  a  tree  structure  as  follows.  Using  the  relationships  in 
the  appropriate  column  of  Table  3  or  Table  4>  all  successors  for 
the  name  are  retrieved  from  the  data  base  and  placed  on  a  stack. 
Then,  the  first  name  is  removed  from  the  stack,  placed  in  its  proper 
location  in  the  data  structure,  and  all  successors  for  that  name  are 
retrieved  and  placed  on  the  stack.  This  procedure  continues,  with 
names  being  removed  from  the  top  of  the  stack,  placed  in  the  data 
structure,  and  used  to  obtain  further  names,  which  are  then  placed 
on  the  stack.  At  any  stage  of  this  procedure,  no  names  will  be  put 
on  the  stack  if  one  of  the  following  is  true: 

1.  The  current  name  has  no  successors 

2.  The  current  name  has  been  encountered  earlier,  and  is 
therefore  at  the  end  of  a  chain  or  forms  a  loop  with 
some  portion  of  a  chain  traced  earlier. 

3.  The  number  of  links  that  has  been  traced  on  the  current 
chain  is  equal  to  the  limit  set  by  the  LINKS  parameter. 

(For  every  input  name  for  which  this  occurs,  the  message 

URA372:  EPSUCC:  LINK  LIMIT  SPECIFIED  WAS  REACHED 

will  be  printed.) 

Thus,  in  any  of  these  cases  the  size  of  the  stack  will  decrease. 

The  entire  procedure  is  complete  when,  after  any  search,  the  stack 
is  empty. 

The  data  structure  constructed  from  all  names  found  as  above  is 
broken  into  page-sized  units  and  is  printed  a  page  at  a  time. 

The  process  described  above  is  repeated  until  no  more  names  remain 
in  the  input  stream. 
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Usage 


The  EXTENDED  PICTURE  is  very  similar  in  content  to  the  PICTURE 
report  and  therefore,  most  usages  of  the  PICTURE  report  apply  to 
the  EXTENDED  PICTURE  report. 

In  addition,  the  EXTENDED  PICTURE  report  provides  a  comprehensive 
view  of  the  information  flow  and  structure  aspects  of  the  target 
system  for  inclusion  in  the  final  specifications  of  the  system,  or 
as  an  aid  in  communicating  this  information  to  others. 

Problem  definers  may  use  the  EXTENDED  PICTURE  report  to  visually 
analyze  the  description  of  particular  objects  and  the  system  as 
a  whole,  for  completeness.  Table  5  presents  all  completeness 
checks  that  can  be  made  by  visually  scanning  EXTENDED  PICTURE 
reports. 

Examples 

Figure  31  presents  an  EXTENDED  PICTURE  of  structure  information 
for  the  PROCESS  “hourly-employee-processing. 11 

Figure  32  presents  an  EXTENDED  PICTURE  of  data  flow  information 
for  the  INTERFACE  “payroll-department . 11  The  amount  of  information 
presented  was  limited  by  setting  LINKS=3. 
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STRUCTURE: 


SET 

1 

-  check  that  SET  is  broken  down  into 

ENTITIES,  or  INPUTS  or  SETS. 

INPUT/OUTPUT/ 
GROUP /ENTITY  . 

-  check  that  these  are  eventually  broken 
down  into  ELEMENTS. 

GROUP /ELEMENT 

check  that  these  are  contained  within  some 
larger  data  structure. 

FLOW: 


PROCESS 

check  that  information  produced  is  used  in 
some  manner. 

-  Check  that  information  used  has  been  made 
available  (produced)  in  some  manner. 

-  check  that  all  PROCESSES  interact  with  data 
in  some  manner. 

INTERFACE 

-  check  that  these  all  generate  INPUTS  to 
the  system  and/or  receive  OUTPUTS • 

-  check  that  the  OUTPUTS  received  have  been 
generated  in  some  manner. 

-  check  that  the  INPUTS  generated  are  used  in 
some  manner. 

SET 

-  check  that  all  these  are  USED,  UPDATED  and/or 
DERIVED  in  some  manner. 

INPUT /OUTPUT/ 

ENTITY 

-  check  that  a  LI  these  are  produced  in  some 
manner  and/or  used  in  some  manner. 

GROUP /ELEMENT 

-  check  that  all  these  are  produced  in  some 
manner  and/or  used  in  some  manner. 

Table  5 

Completeness  Checks  that  may  be  made  by 
Visual  Analysis  of  the  EXTENDED  PICTURE  report 
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Figure  32  (Continued) 


formatted  problem  statement 


.  • 

Purpose 

To  present  in  the  Language  format,  all  description  given  about  one 
or  more  names  in  an  Analyzer  data  base. 

Information  Presented 


The  report  presents  for  each  name  used  as  input  when  generating  the 
report,  all  information  directly  available  in  the  data  base  for  that 
name  and  its  relationships  with  other  names  in  the  data  base.  Since 
this  report  can  be  generated  for  any  type  of  name  and  the  report  pre¬ 
sents  all  Language  relationships  specified  for  each  name  type,  it  must 
present  all  relationships  as  specified  in  "User  Requirement  Language, 
Language  Reference  Manual".* 

Format 


All  information  presented  in  this  report  is  presented  as  legal  Language 
statements  and  is  formatted  according  to  the  values  of  the  margin 
parameters.  The  margin  parameters  have  the  following  effects  on  the 


format : 

AMARG 

indicates 
name  pair 

the  column  at  which  the  first  name  of  a 
is  to  be  outputted. 

BMARG 

indicates 
name  pair 

the  column  at  which  the  second  name  of  a 
is  to  be  outputted. 

CMARG 

specifies 
where  the 

the  number  of  columns  between  SMARG  and 
text  starts  for  a  comment  entry. 

1IMARG 

indicates 
a  section 

the  column  where  the  user  defined  name  in 
header  is  to  be  outputted. 

NMARG 

- 

indicates  the  column  where  the  first  name  of  a  name 
list  or  name  used  in  a  Language  statement  is  outputted. 

RNMARG 

- 

specifies 

list. 

the  right  hand  margin  for  names  in  a  name 

SMARG 

- 

indicates  the  column  in  which  the  Language  statement 
headers  will  be  started. 

*ISBQS  Working  Paper  No.  68. . 


Tigure  33:  illustrates  the  margin  parameters  with  respect  to  a 

part  of  an  actual  FORMATTED  PROBLEM  STATEMENT. 


hmarc 


CMARG 

SMARG 

KMARG 

AMARG 


<- 


- 


BMARG  c~ 


PROCESS : 


salaried-employee-processing; 


DESCRIPTION: 

This  process  produces  the  pay  statement  for  salaried 


employees  once  a  month.  ; 


SYNONYMS  ARE: 


s-emp-proc, 
s3  ; 


ATTRIBUTES  ARE: 

complexity-level  high  ; 


Figure  33 


All  Language  statements  presented  in  the  FPS  are  numbered  sequentially. 

For  each  type  of  Language  section,  the  statements  within  the  section  are 
ordered  as  given  in  Table  6.  Sections  in  the  FPS  which  describe  undefined 
names  or  relationships  not  allowed  by  the  syntax  of  the  Language  are 
presented  as  comment  statements,  i.e.,  preceded  by  the  characters  /*  and 
succeeded  by  the  characters  */. 
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CONDITION  section  SYNONYMS 

DESCRIPTION 

'  .  SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

BECOMING  TRUE  IS  CALLED 
BECOMING  FALSE  IS  CALLED 
TRUE  WHILE 
FALSE  WHILE 

RESPONSIBLE-PROBLEM-DEFINER 

SECURITY 

SOURCE 

DEFINE  section  SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

APPLIES 

SUBSETTING-CRITERION 

MAINTAINED 

/*  CONTAINED  */ 

/*  CONNECTIVITY  */ 

/*  CARDINALITY  */ 

/*  HAPPENS  */ 

/*  VALUE  */ 

RESPONSIBLE-PROBLEM-DEFINER 

SECURITY 

SOURCE 

ELEMENT  section  SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

CONTAINED 

ASSOCIATED  WITH 

IDENTIFIES 

SUBSETTING-CRITERION 

DERIVED 

USED 

UPDATED 

VALUES 

RESPONSIBLE-PROBLEM-DEFINER 

SECURITY 

SOURCE 


TABLE  6 
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ENTITY  section 


I 


EVENT  section 


GROUP  section 


SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

CONTAINED 

ASSOCIATED  WITH 

IDENTIFIES 

SUBSETTING-CRITERION 

DERIVED 

USED 

UPDATED 

VALUES 

RESPONSIBLE-PROBLEM-DEFINER 

SECURITY 

SOURCE 

SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

TRIGGERS 

WHEN  TRUE 

WHEN  FALSE 

ON  INCEPTION 

ON  TERMINATION 

HAPPENS 

RESPONSIBLE-PROBLEM-DEFINER 

SECURITY 

SOURCE 

SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

CONTAINED 

CONSISTS 

IDENTIFIES 

SUBSETTING-CRITERION 

ASSOCIATED-WITH 

DERIVED 

USED 

UPDATED 

RESPONSIBLE-PROBLEM-DEFINER 

SECURITY 

SOURCE 
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INPUT  sectipn 

SYNONYMS 

« 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

PART 

SUBPARTS 

CONTAINED 

CONSISTS 

GENERATED 

RECEIVED 

USED 

HAPPENS 

RESPONSIBLE-PROBLEM-DEFINER 

SECURITY 

SOURCE 

INTERFACE  section 

SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

PART 

SUBPARTS 

GENERATES 

RECEIVES 

RESPONSIBLE 

RESPONSIBLE-rROBLEM-DEFINER 

SECURITY 

SOURCE 

INTERVAL  section 

SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

CONSISTS 

/*  CONTAINED  */ 

/*  HAPPENS  */ 

RESPONSIBLE-PROBLEM-DEFINER 

SECURITY 

SOURCE 

MEMO  section 

SYNONYMS 

DESCRIPTION 

KEYWORDS 

ATTRIBUTES 

APPLIES 

RESPONSIBLE-PROBLEM-DEFINER 

SECURITY 

TABLE  6  (Coni  j  mir.i ) 
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OUTPUT  section 


SYNONYMS 


DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

PART 

SUBPARTS 

CONTAINED 

CONSISTS 

DERIVED 

GENERATED 

RECEIVED 

HAPPENS 

RESPONSIBLE-PROBLEM-DEFINER 

SECURITY 

SOURCE 


PROBLEM-DEFINER  section 


SYNONYMS 


DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

MAILBOX 

RESPONSIBLE 

SECURITY 

SOURCE 


PROCESS  section 


SYNONYMS 


DESCRIPTIONS 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

PART 

SUBPARTS 

UTILIZED 

UTILIZES 

RECEIVES 

generates 

derives 

maintains 

UPDATES 

USES 

PROCEDURE 

INCEPTION-CAUSES 

TERMINATION-CAUSES 

TRIGGERED 

HAPPENS 

RESPONSIBLE-PROBLEM-DEFINER 

SECU1U  TY 

SOURCE 
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RELATION  section 

SYNONYMS 

DESCRIPTION 

« 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

ASSOCIATED-DATA 

BETWEEN 

DERIVATION 

MAINTAINED 

CONNECTIVITY 

CARDINALITY 

RESPONSIBLE-PROBLEM-DEFINER 

SECURITY 

SOURCE 

SET  section 

SYNONYMS 

DESCRIPTION 

SEE-MEMO 

KEYWORDS 

ATTRIBUTES 

CONSISTS 

SUBSET 

SUBSETS 

SUBSETTING-CRITERIA 

DERIVATION 

DERIVED 

USED 

UPDATED 

CARDINALITY 

VOLATILITY-MEMBER 

VOLATILITY-SET 

RESPONSIBLE-INTERFACE 

RESPONSIBLE-PROBLEM-DEFINER 

SECURITY 

SOURCE 

TABLE  6  ( Continued) 


Options  and  Alternatives 


Aside  from  the  variations  in  the  report  format  as  the  result  of 
assignment  of  the  margin  parameters,  there  are  a  few  other  para¬ 
meters  which  modify  the  format  in  some  way.  These  parameters  are 
given  below  with  the  effect  they  have  on  the  report  format. 

1.  NEW-LINE  -  specifies  that  the  first  name  in  a  list 

of  names  for  Language  statements  is  started  on 
the  line  following  the  statement  header. 

NONEW-LINE  -  specifies  that  the  names  in  the  name  list  begin 

on  the  same  line  as  the  Language  statement. 

For  example,  with  NEW-LINE  in  effect,  a  Language  statement  would 

be  printed  as  follows: 

SYNONYMS  ARE: 

s-emp-proc, 

s3; 

With  NONEW-LINE  in  effect,  the  statements  are  printed  as  follows: 


SYNONYMS  ARE:  s-emp-proc, 
s3; 

2.  NEW-PAGE  -  specifies  that  each  section  (description  of 

of  single  name)  presented  in  the  report  would 
be  printed  beginning  at  the  top  of  a  new  page. 

NONEW-PAGE  -  specifies  that  sections  are  printed  one  after 

another. 

When  maintaining  an  up-to-date  copy  of  the  FPS,  it  is  often  desireable 
to  generate  the  FPS  for  all  names  in  the  data  base  wTith  the  NEW- 
PAGE  option.  Any  modifications  to  the  description  in  the  data  base 
can  be  recorded  by  generating  an  FPS  (with  the  NEW-PAGE  option  again) 
for  those  names  affected  by  the  modification. 

3.  ONE-PER-LINE  -  specifies  that  the  names  in  a  name  list  within 

a  given  statement  be  presented  one  per  line. 

SEVERAL-PER-LINE  -  specifies  that  the  names  in  a  name  list  be 

presented  as  many  as  possible  on  a  line. 

Some  information  in  the  FPS  can  be  included  or  left  out,  depending  on 
the  parameters  used  when  generating  it.  Each  parameter  and  its 
effect  is  given  below. 

1 .  COMMENT  -  specifies  that  comment  statements  for  descrip¬ 

tions  of  indefined  names  and  relationships  not 
allowed  by  the  Language  syntax  are  to  be  included 
where  applicable  in  the  report. 
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specifies  that  the  comment  statements 
are  not  printed. 

specifies  that  descriptions  for  names 
which  are  described  by  a  DEFINE  section 
(ATTRIBUTE,  ATTRIBUTE- VALUE,  KEYWORD, 

MAILBOX,  SECURITY,  SOURCE,  SUBSETTING- 
CRITERION,  and  SYSTEM-PARAMETER  names) 
are  included  in  the  report  when  these 
names  are  given  as  input. 

specifies  that  the  description  of  any 
name  described  by  a  DEFINE  section  is 
not  presented  in  the  report. 

specifies  that  the  descriptions  for  names 
which  are  SYNONYMS  for  other  names  in  the 
data  base  are  presented  in  the  report  by 
the  DESIGNATE  section. 

specifies  that  the  descriptions  for  names 
that  are  SYNONYMS  are  not  presented  in  the 
report. 

For  each  name  given  as  input  to  the  command  producing  the  report,  the 
report  presents  the  appropriate  section  to  describe  the  name.  For 
example,  when  a  PROCESS  name  is  given,  it  is  described  in  a  PROCESS 
section.  Therefore,  when  a  SYNONYM  name  is  given  as  input,  the  report 
describes  the  SYNONYM  by  a  DESIGNATE  section  rather  than  presenting 
the  description  of  the  name  the  SYNONYM  name  applies  to. 

An  INDEX  for  the  report  is  generated  when  the  INDEX  parameter  is  used. 

The  report  may  be  generated  for  a  single  input  name  (via  the  NAME 
parameter  )  or  for  a  collection  of  input  names  either  specified  by  the 
user  or  retrieved  via  NAME-GEN. 

Analysis 

For  each  name  given  as  input,  the  software  finds  the  name  in  the  data 
base.  If  the  name  cannot  be  found,  the  message: 

/*  NAME  NOT  FOUNT)  IK  D.B.  -  */ 

is  printed  on  the  report.  Each  relationship  the  name  has  with  other 
names  is  printed  in  the  format  of  a  legal  Language  statement.  If  no 
statement  exists,  the  relationship  is  presented  as  a  comment  entry. 
Since  no  Language  section  is  available  to  describe  an  UNDEFINED  name, 
the  description  of  the  name  and  relationships  it  has  with  other  names 
me  presented  as  a  comment  statement. 

Y>.  i/e 

Since  the  FPS  presents  all  the  description  given  about  each  name  in  the 

data  base,,  the  report  is  beneficial  in  checking  the  accuracy  of  each 
description  It  is  usually  recommended  that  an  FPS  for  all  names  be 
maintained  as  a  reference  and  updated  when  changes  are  made  to  the  data 
base. 


NOCOMMENT 

2.  DEFINE 

I 

NODEFINE 

3.  DESG 

NODES G 
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Examples 


Figure  34  presents  an  FPS  for  a  single  name.  This  example  was 
generated  by  the  following  command: 

FORMATTED-PROBLEM-S  TATEM  ENT  NAME-pay roll-processing 

Figure  35  presents  the  report  for  all  ENTITY  names  defined  in  a 
particular  data  base.  This  example  was  generated  by  the  following 
commands: 

NAME-GEN  ENTITY 
FPS 
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FREQUENCY  REPORT 

Purpose 


To  present  all  information  based  on  the  use  of  the  HAPPENS 
statement  in  a  particular  Analyzer  data  base. 

Information  Presented 


The  report  presents  size  and  volume  information  about  all  INPUT, 
OUTPUT,  PROCESS  and  EVENT  names  defined  in  the  data  base  with  respect 
to  the  HAPPENS  statements  connected  to  those  types  of  names.  An 
entry  is  made  in  the  report  for  each  INPUT,  OUTPUT,  PROCESS  and 
EVENT  with  a  HAPPENS  statement  and  the  entries  are  grouped  by  the 
INTERVAL  over  which  the  HAPPENS  statement  is  effective.  SYSTEM- 
PARAMETERS  are  contained  in  each  entry  to  define  the  number  of  times 
the  name  associated  to  the  entry  occurs  within  the  INTERVAL. 

Format 


The  report  presents  all  HAPPENS  statements  relative  to  a  specific 
INTERVAL  whose  name  is  printed  on  a  heading.  For  each  INTERVAL, 
three  headings  are  printed  and  the  frequency  information  pertaining 
to  the  particular  INTERVAL  is  listed  below  these  headings.  The 
headings  are: 

NAME  -  the  nanes  of  the  INPUTS,  OUTPUTS,  PROCESSES 

and  EVENTS  which  HAPPEN  within  the  designated 
INTERVAL  are  listed. 

TYPE  -  the  name  type  of  each  of  the  names  given  under 

NAME  is  listed. 

TIMES  HAPPENS  -  the  SYSTEM-PARAMETER  or  number  used  in  the 

HAPPENS  statement  for  each  of  the  names  given 
under  NAME  is  listed. 

The  INTERVALS  are  presented  alphabetically  in  the  report.  No  ordering 
is  imposed  on  the  names  listed. 

Options  and  Alternatives 

No  options  are  available  for  this  report. 

Analysis 


The  data  base  is  searched  for  an  INTERVAL  name  that  is  connected  to  a 
HAPPENS  relationship.  If  none  are  found,  the  message: 


URA286 : FRINTV :  NO  FREQUENCY  INFORMATION  IN  DATA  BASE 

is  printed.  If  an  INTERVAL  name  is  found,  it  is  printed  out  and  for  each 
HAPPENS  statement  connected  to  it  the  name  the  HAPPENS  statement  applies 
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The  search  for  another  INTERVAL  is  continued  until  all  names  have 
been  testdd. 

Usage 

The  report  is  helpful  to  analysts  in  checking  that  all  items  in  the 
description  which  are  to  be  logically  related  via  their  frequency 
are  grouped  together. 

The  report  is  also  beneficial  to  system  designers  when  considering 
the  relationships  of  various  parts  of  system  with  respect  to  frequency, 
and  the  amount  of  input  and  output  to  be  handled  by  the  target  system. 

Examples 

i'igurs  36  presents  the  FREQUENCY  REPORT  for  a  small  Language  description 
of  a  target  system. 
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Figure  36 


IDENTIFIER  INFORMATION  REPORT 


Purpose 

To  present  all  information  based  on  the  use  of  IDENTIFIERS  for 
ENTITIES  in  a  particular  Analyzer  data  base. 

Information  Presented 

If  IDENTIFIER  names  are  used  as  input  when  generating  this  report  (and 
the  IDENTIFIER  parameter  is  specified) ,  those  ENTITIES  which  the  input 
names  IDENTIFY  are  presented  in  the  report. 

If  ENTITY  names  are  used  as  input  when  generating  the  report  (and  the 
ENTITY  parameter  is  specified) ,  those  IDENTIFIERS  which  the  input  names 
are  IDENTIFIED  by  are  presented  in  the  report. 

In  either  case,  the  information  is  presented  as  a  matrix.  An  analysis 
of  the  information  in  the  matrix  produces  some  statistics  showing  the 
number  of  IDENTIFIERS  each  ENTITY  in  the  matrix  had  and  the  number  of 
ENTITIES  each  IDENTIFIER  identifies  in  the  matrix. 

Format 

If  the  IDENTIFIER  parameter  is  used  when  generating  the  report,  any 
names  given  as  input  which  do  not  IDENTIFY  any  ENTITY  in  the  data  base 
are  flagged  at  the  beginning  of  the  report.  If  the  ENTITY  parameter 
is  used  when  generating  the  report,  any  names  given  as  input  which  are 
not  IDENTIFIED  by  any  IDENTIFIER  in  the  data  base  are  flagged  at  the 
beginning  of  the  report. 

Two  lists  of  names  are  then  presented,  one  labeled  ROW  NAMES  and  the 
other  COLUMN  NAMES.  If  the  IDENTIFIER  parameter  was  used  when  generating 
the  report,  the  names  designated  as  ROW  NAMES  are  those  which  were  given 
as  input.  If  the  ENTITY  parameter  was  used  when  generating  the  report, 
the  names  designated  as  COLUMN  NAMES  are  those  which  were  given  as  input. 

In  any  case,  each  name  under  ROW  NAMES  IDENTIFIES  one  or  more  names 
under  COLUMN  NAMES  and  each  name  under  COLUMN  NAMES  is  IDENTIFIED  by  one 
or  more  names  under  ROW  NAMES. 

A  matrix  is  then  printed  to  show  the  relationships  between  the  names 
designated  as  ROW  NAMES  (which  are  represented  by  the  rows  of  the  matrix) 
and  the  names  designated  as  COLUMN  NAMES  (which  are  represented  by  the 
columns  of  the  matrix).  The  rows  and  columns  of  the  matrix  are  numbered 
to  correspond  to  the  number  assigned  to  each  name  in  the  list  of  ROW 
NAMES  and  COLUMN  NAMES,  respectively. 

An  asterisk  (*)  entry  at  the  intersection  of  a  particular  row  and  column 
of  the  matrix  designates  that  the  name  represented  by  the  row  IDENTIFIES 
the  ENTITY  represented  by  the  column. 

Inspection  of  an  entire  row  reveals  all  ENTITIES  that  a  particular  name 

(represented  by  the  row)'  IDENTIFIES.  Inspection  of  an  entire  column 
reveals  all  IDENTIFIERS  for  the  particular  name  represented  by  the 
column. 
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A  summary  section  is  also  included  in  the  report  presenting  for  each 
ROW  NAME: 

-  The  row  it  was  represented  by  in  the  matrix  (ROW) 

-  Its  name  type  (TYPE) 

-  The  number  of  *  entries  in  its  row  (or  the  number  of  ENTITIES 
it  IDENTIFIES)  (COUNT) 

The  summary  presents  for  each  COLUMN  NAME: 

-  The  column  it  was  represented  by  (COLUMN) 

-  Its  name  type  (TYPE) 

The  number  of  *  entries  in  its  column  (or  the  number  of 
IDENTIFIERS  for  it)  (COUNT) 

The  summary  section  for  ROW  and  COLUMN  names  is  ordered  in  decreasing 
order  of  COUNT. 

Options  and  Alternatives 

The  report  must  be  generated  using  either  the  IDENTIFIER  or  ENTITY 
parameter.  If  the  IDENTIFIER  parameter  is  used, all  names  given  as 
input  must  be  IDENTIFIER  names.  If  the  ENTITY  parameter  is  used,  all 
names  given  as  input  must  be  ENTITY  names. 

The  report  may  be  generated  for  a  single  input  name  (via  the  NAME 
parameter)  or  for  a  collection  of  input  names  either  specified  by  the 
user  or  retrieved  via  NAME-GEN. 

Analysis 


For  each  name  given  as  input,  the  software  finds  the  name  in  the  data 
base.  If  the  name  is  not  found,  the  message: 

URA099 : IDENTR:  NAME  NOT  IN  D.  B.  -  or 

URA052 : IDENTC:  NAME  NOT  IN  D.  B.  - 


is  printed  depending  on  whether  the  IDENTIFIER  or  ENTITY  parameter  was 
specified  for  the  command,  respectively. 

If  the  IDENTIFIER  parameter  is  used,  each  name  given  as  input  is  checked 
that  it  IDENTIFIES  one  or  more  ENTITIES.  If  it  does  not,  the  name  is 
listed  under  the  message: 


URA30A : IDENTR  : 


THE 


FOLLOWING  NAMES  DO  NOT  IDENTIFY  ANYTHING 


The  ENTITIES  that  are  IDENTIFIED  by  the  input  names  are  found.  The  list 
of  all  input  names  and  the  list  of  a  ll  ENTITIES  retrieved  ir.  then  nr  '  < 


!)  the  r.NTf '  -  -1  >  I  -  i  .  n.  od  ,  oech  mwo  given 
l'. it  it  is  if  •  i  .  ±,iu  ny  n.:o  or  more  I DLNYI  i’iKdh 
name  is  listed  under  •■.he.  message: 


in]-;-:  is  check.-d 
f  it  does  not,  ti».- 


U  RAJ  OS :  J I  if  NiY; 


THF  FOLLOWING  NAMES  ARF.  NOT  DENTl  TIED  j’Y 
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The  IDENTIFIERS  for  the  ENTITIES  given  as  input  are  found.  The  list 
of  all  injjut  names  and  the  list  of  all  IDENTIFIERS  retrieved  is  than 
printed. 

A  matrix  is  printed  out  to  illustrate  the  relationships  between  the 
names  in  the  two  lists  and  each  relationship  is  designated  by  an 
asterisk. 

A  summary  is  then  produced  by  counting  the  number  of  asterisks  appear¬ 
ing  in  each  row  and  column  of  the  matrix. 

Usage 

The  report  presents  information  that  aids  the  analyst  in  checking  the 
completeness  and  consistency  of  the  problem  statement  by; 

1  -  identifying  those  ENTITIES  which  do  not  have  IDENTIFIERS. 

This  can  be  accomplished  by  the  following  Analyzer  commands: 

% 

NAME-GEN  ENTITY 
ENTITY- IDENTIFIER  ENTITY 

2  -  being  in  an  easy-to-analyze  format  to  check  that  the 

IDENTIFIERS  defined  for  the  problem  statement  are  being 
used  properly.  For  example,  a  typing  error  may  result 
in  an  IDENTIFIER  being  used  in  the  wrong  context. 

The  report  aids  the  system  designer  by  presenting  those  ENTITIES  with 
the  same  IDENTIFIERS  and  aids  in  determining  a  consistent  and  well- 
defined  identifier  coding  structure. 

Examples 

Figure  37.  presents  the  report  using  the  ENTITY  parameter.  The  Analyzer 
commands  used  to  generate  this  example  were: 

NAME-GEN  ENTITY 
ENTITY-IDENTIFIER  ENTITY 
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KWIC  INDEX 


Purpose 

To  present,  in  an  easy  to  inspect  format,  logical  groupings  of  names 
defined  in  a  particular  Analyzer  data  base  with  respect  to  the  spell¬ 
ing  of  the  names. 

Information  Presented 


The  report  presents,  for  all  those  names  used  as  input,  an  alphabetical 
listing  consisting  of  an  entry  for  each  name  as  it  appears  as  input 
and  entries  for  each  permutation  of  the  name  (about  the  dashes) .  For 
example,  if  the  name  hourly-employee-f orra  was  supplied  as  input,  there 
would  be  entries  for 

employment-form  hourly 

form  hourly-employment 

hourly-employment- form 

in  the  report.  When  there  are  several  names  used  as  input  then  all 
names  with  the  word  "employment11  in  them  would  have  entries  group 
together,  all  those  with  "form"  would  be  grouped  together,  etc. 

Format 


The  entries  in  the  report  are  ordered  alphabetically  and  numbered 
sequentially.  There  are  two  parts  of  each  entry,  the  right  hand  side 
of  the  entry  presents  that  part  of  the  user  defined  name  that  has  been 
stripped  off  for  a  permutation  of  the  name  and  the  left  hand  side 
of  the  entry  presents  the  remaining  part  of  the  name.  The  distance 
(the  number  of  columns)  between  the  right  and  left  sides  of  the  entry 
can  be  varied  by  the  value  assigned  to  the  DIF  parameter. 

Options  and  Alternatives 

The  DIF  parameter  may  take  on  any  value  from  2  to  52. 

Analysis 

Each  name  given  as  input  to  the  software  generating  the  report  is 
inspected,  separated  at  the  dashes  in  the  name  and  a  list  is  formed 
consisting  of  the  original  name  and  all  permutations  of  the  name. 

After  all  names  in  the  input  list  have  been  processed,  the  newly  formed 
list  is  sorted  and  presented  as  the  report. 


Usage 


The  KWIC  INDEX  aids  analysts  in  maintaining  naming  conventions  used 
in  the  target  system  description  process  and  for  finding  names  in  the 

Description  based  on  the  keyword  within  the  names. 


It  Is  often  desirable  to  use  some  convention? 
objects  defined  in  o  1  argot  svrum  descri  j»t  i .  u 
in  nn i n i  .  ;  ’  *•  v  tii  .  for  •  ;i<  .p  I  •  • ,  by  Js  t:  i  :  . 


n  a x signing  name s  \  o 
and  L ;  V'.iC  lXDI'N  a.  ids 
.  !M‘  to  i  I  i  I  ng  Ana  1  -  i 
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commands : 


NAME-GEN  ELEMENT 
KWIC 

a  KWIC  INDEX  is  presented  for  all  ELEMENT  names  so  that  consistency 
of  naming  can  be  checked. 

Examples 


Figure  38  presents  a  KWIC  INDEX  for  INPUT  names  defined  in  a  small 
problem  statement. 


l 


>♦ 
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NAME  GEN 


Purpose 

To  present  all  names  in  the  data  base  with  respect  to  some  selection 
criteria  (as  specified  by  parameters) . 

Information  Presented 


The  report  presents  a  list  of  names  and  their  corresponding  name 
types.  The  types  of  the  names  in  the  list  are  specified  by  the 
parameters  used  in  the  command  producing  the  report.  For  example, 
when  the  INTERFACE  and  PROCESS  parameters  are  given,  the  report 
presents  all  INTERFACE  and  PROCESS  names  in  the  data  base.  When  the 
PROCESS  and  KEYWORD^ terminal  parameters  are  given,  the  report  presents 
all  PROCESSES  in  the  data  base  that  have  the  KEYWORD  "terminal" 
associated  as  part  of  their  description. 

Format 


An  entry  in  the  report  is  printed  for  each  name  retrieved  and  consists 
of : 


the  name  retrieved,  and 
the  name  type  of  the  name 

The  entries  within  the  report  are  ordered  in  one  of  two  ways:  alpha¬ 
betically  on  the  names  when  the  ORDER=ALPHA  parameter  is  in  effect, 
and  alphabetically  on  the  names  within  name  type  (which  are  also 
ordered  alphabetically)  when  the  ORDER=HYTYPE  parameter  is  in  effect. 

Options  and  Alternatives 

Several  parameters  for  the  command  generating  the  report  specify  the 
types  of  names  that  will  be  retrieved  from  the  data  base  and  presented 
in  the  report.  The  following  types  of  names  can  be  retrieved  when  the 
parameter  (of  the  same  name)  is  given  for  the  command: 


ATTRIBUTE 

ELEMENT 

GROUP 

INTERVAL 

MEMO 

PROCESS 

SOURCE 

UNDEFINED 


ATTRIBUTE- VALUE 

ENTITY 

INPUT 

KEYWORD 

OUTPUT 

SECURITY 

SUBSETTING-CRITERION 


CONDITION 

EVENT 

INTERFACE 

MAILBOX 

PROBLEM-DEFINER 

SET 

SYSTEM- PARAMETER 


If  none  of  these  parameters  are  specified,  no  names  will  be  presented. 
If  the  ALL  parameter  is  specified,  the  names  of  all  name  types  except 
SYNONYM  and  UNDEFINED  will  be  presented.  If  the  TOTAL  parameter  is 
specified,  every  r.aire  in  the  data  base  is  presented. 
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If  all  names  In  the  data  base  except  for  SYNONYMS,  UNDEFINED  names  and 
PROBLEM-DEFINERS  were  presented,  the  following  parameters  would  be 
used : 


ALL  NOPROBLEM-DEFINER 

A  'NO*  prefix  for  any  of  the  name  type  parameters  designates  that  names 
of  that  type  are  not  to  be  presented.  Specifying  ALL  has  the  effect  of 
setting  switches  to  indicate  that  all  name  types  are  to  be  presented. 
Specifying  NOPROBLEM-DEFINER  after  the  ALL  parameter  has  the  effect  of 
setting  a  switch  to  indicate  that  PROBLEM-DEFINER  names  are  not  to  be 
retrieved. 

Four  other  parameters  specify  the  types  of  names  retrieved  from  the 
data  base.  Names  used  as  IDENTIFIERS  of  ENTITIES  can  be  presented  by 
specifying  IDENTIFIER  as  a  parameter.  Names  which  are  uspd  as  IDENTIFIERS 
and  are  also  defined  as  ELEMENTS  are  presented  when  the  IDENTIFIER- 
ELEMENT  parameter  is  specified.  Names  which  are  used  as  IDENTIFIERS  and 
are  also  defined  as  GROUPS  are  presented  when  the  IDENTIFIER-GROUP  para¬ 
meter  is  specified. 

All  names  which  belong  to  the  SUBPARTS  structure  for  a  given  name  (as 
would  be  retrieved  for  the  STRUCTURE  report)  can  be  retrieved  by  specify¬ 
ing: 


SUBPARTS- OF=name 


where  the  name  is  an  INPUT,  OUTPUT,  PROCESS  or  INTERFACE  name  which  has 
SUBPARTS  information  defined  for  it.  The  number  of  levels  to  go  down 
and  retrieve  names  to  present  in  the  report  is  specified  by  the  SUBLEVEL 
parameter.  If  SUBLEVEL=0,  then  all  levels  of  names  are  presented. 

If  SUBLEVEL=1,  then  only  those  names  which  are  PART  OF  the  SUBPARTS  OF 
name  are  presented.  The  following  picture  may  clarify  the  association 
between  the  value  of  SUBLEVEL  and  the  names  presented. 


-  SUBPARTS-OF  name 

-  SUBLEVEL=1 

-  SUBLEVEL=2 

-  SUBLEVEL=3 


-  SUBLEVEL=0 


Generation  of  the  report  with  SUBPAR'i'S-OF=Sl  and  SUBLEVEL=3  would 
present  S2,  S3,  S4,  S5,  S6,  S7,  S8,  S9,  S  10  and  Sll  in  the  report. 
Generation  of  the  report  with  SUBPARTS-0F=S1  and  SUBLEVEL=1  would 
present  the  names  S2,  S3, and  54. 
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Of  the  various  types  of  names  retrieved  by  any  of  the  above  parameters, 
additional  selectivity  is  provided  by  the  KEY  and  PD  parameters.  The 
KEY  parameter  specifies  that  for  all  names  retrieved,  only  those  which 
have  the  designated  KEYWORD  are  presented  in  the  report.  For  example, 
if  the  following  parameters  were  given: 

PROCESS  KEY=terminal 

only  those  PROCESSES  with  the  KEYWORD  "terminal"  would  be  presented  in 
the  report. 

Likewise,  the  PD  parameters  specifies  that  for  all  names  retrieved, 
only  those  which  have  the  designated  PROBLRM-DEFINER  are  presented  by 
the  report.  When  both  of  these  parameters  are  used  together,  only 
those  names  which  satisfy  both  requirements  are  presented.  For  example, 
if  the  parameters: 

INPUT  OUTPUT  KEY=weekly  PD=michel-j-bastarache 

were  given  only  those  INPUTS  and  OUTPUTS  which  had  the  KEYWORD  "weekly" 
and  the  P  RO  1>  LEM- DE  FINER  "michel- j-bastarache"  would  be  presented  in 
the  report. 

Specification  of  the  SYNONYM  parameter  presents  all  SYNONYMS  for  each 
name  retrieved  in  the  report  in  addition  to  the  basic  form  of  the 
name.  If  only  the  SYNONYMS  are  desired,  the  basic  names  may  be  suppressed 
by  specifying  the  N0BAS1C  and  SYNONYM  parameters.  With  standard  defaults 
in  effect,  the  BASIC  and  NOSYNONYM  parameters  are  used. 

Analysis 


Each  name  defined  in  the  data  base  is  checked  against  the  parameters 
for  the  command.  If  it  satisfies  the  requirements  as  specified  by  the 
parameters,  it  is  placed  in  a  list.  After  all  names  in  the  data  base 
have  been  checked,  the  list  is  sorted  as  the  report. 

If  NAME-GEN  is  generated  for  an  empty  data  base,  the  message: 

URA049:  MAINNG :  NO  NAMES  IN  DATA  BASE 

will  be  printed. 

If  the  PD  parameter  is  used  in  generating  the  report  and  the  name  given 
as  the  PD  value  is  not  a  name  defined  in  the  data  base,  the  message: 

URA047:  MAINNG:  PD  NOT  FOUND  IN  DATA  BASE 

will  be  printed.  If  the  name  is  found,  but  is  not  a  PROBLEM-DF.F1NKR 
and  related  to  any  names  in  the  data  base,  the  message: 

URA0B7 :  FNDPD:  THIS  IS  NOT  A  PD  FOR  ANY  NAMES  - 
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Figure  38 


If  the  KEY  parameter  is  used  in  generating  the  report  and  the  name  given 
as  the  KEY  *value  is  not  a  name  defined  in  the  data  base,  the  message: 

URA048:  MAINNG:  KEYWORD  NOT  FOUND  IN  DATA  BASE  - 

will  be  printed.  If  the  name  is  found,  but  is  not  a  KEYWORD  and  not 
related  to  any  names  in  the  data  base,  the  message: 

URA030:  FNDKEY:  THIS  IS  NOT  A  KEYWORD  FOR  ANY  NAMES  - 

is  printed. 

If  the  SUBPARTS-OF  parameter  is  used  in  generating  the  report  and  the 
name  given  as  the  SUBPARTS-OF  value  is  not  a  name  defined  in  the  data 
base,  the  message: 

URA059 :  MAINNG:  SUBPARTS-OF  NAME  NOT  IN  DATA  BASE  - 

is  printed.  If  the  name  is  found  but  it  is  not  a  PROCESS,  INPUT,  OUTPUT 
or  INTERFACE  name,  the  message: 

URA089:  MAINNG:  NAME  MUST  BE  INPUT,  OUTPUT,  PROCESS  OR  INTERFACE 

FOR  "SO"  PARAMETER 

is  printed. 

Usage 

It  is  an  important  aid  to  the  analyst  in  obtaining  other  reports  and 
outputs.  For  example,  the  analyst  can  ask  for  a  list  of  all  SET,  ENTITY 
and  GROUP  names  and  with  this  list  then  ask  for  a  CONTENTS  REPORT  for 
these  names. 

It  is  also  used  by  the  analyst  as  a  reference  to  what  names  have  been 
used  and  how  they  have  been  used  (i.e.,  what  their  name  types  are). 

The  output  can  also  be  used  effectively  by  project  management  to  measure 
productivity  of  the  project  members.  This  can  be  done  by  retrieving 
a  list  of  all  names  in  the  data  base  defined  by  a  particular  problem  definer 
(analyst)  and  comparing  it  to  previous  lists. 

Finally,  the  NAME  GEN  output  can  become  an  integral  part  of  the  final 
specifications  as  it  acts  as  a  directory  in  specifying  name  lists 
corresponding  to  certain  selection  criteria  (a  directory  of  all  data 
elements  may  be  desired  before  a  section  which  deals  with  the  definition 
of  each  element  in  detail) . 

Ex*i  mp_]  es 

Figure  39  presents  a  NAME'  GEN  report  produced  for  all  INPUT  names 
defined  in  n  data  huso.  The  command  used  to  generate  this  example  was: 


NAME- GEN  INPUT 


Figure  40  presents  a  NAME-GEM  report  produced  for  all  INPUT, 
OUTPUT  and  ENTITY  names  in  a  data  base  given  in  alphabetical  order. 
The  command  used  to  generate  this  example  was: 

NAME-GEN  INPUT  OUTPUT  ENTITY 

Figure  41  presents  the  report  for  all  names  in  the  data  base 
which  have  "michel-j-bastarachc'  defined  as  their  PROBLEM  DEFINER. 
The  command  used  to  generate  this  example  was: 

NAME-GEN  ALL  PD=michel-j-bastarache 

Figure  42  presents  the  report  for  all  PROCESS  names  in  the  data 
base  which  have  "terminal"  defined  as  one  of  their  KEYWORDS.  The 
command  used  to  generate  this  example  was: 

NAME-GEN  PROCESS  KEY=terminal 

Figure  43  presents  the  report  for  SUBPARTS  for  the  PROCESS  name 
"payroll-processing".  Only  the  first  sublevel  of  the  SUBPARTS 
structure  is  presented.  Also,  the  synonym  of  "payroll-processing" 
was  specified  for  the  SUBPARTS-OF  parameter  rather  than  the  full 
name.  The  command  used  to  generate  this  example  was: 

NAME- GEN  SUBPARTS-OF=payproc  LEVELS=1 
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NAME  LIST 


Purpose 

To  present  a  list  of  all  names  defined  in  a  particular  Analyzer 
data  base,  the  name  type  associated  with  the  name  and  SYNONYMS 
defined  for  each  name. 

Information  Presented 


The  report  presents  every  name  currently  defined  in  the  user's 
data  base,  the  name  type  associated  with  each  name  and  the 
SYNONYMS  associated  with  each  name. 

Format 

An  entry  in  the  report  is  printed  for  each  name  in  the  Analyzer 
data  base  and  consists  of: 

-  the  name, 

-  the  name  type  of  the  name,  and 

-  any  SYNONYMS  for  the  name, 

which  are  listed  under  the  headings:  NAME,  TYPE,  and  SYNONYM, 
respectively . 

The  entries  within  the  report  are  ordered  in  one  of  two  ways: 
alphabetically  on  the  names  when  the  ORDER=ALPHA  parameter  is 
in  effect  and,  alphabetically  on  the  names  within  name  type 
(which  are  also  ordered  alphabetically)  when  the  ORDER=BYTYPE 
parameter  is  in  effect. 

If  no  SYNONYMS  are  available  for  a  particular  name  a  dash  (-)  is 
printed  under  the  SYNONYM  heading.  If  more  than  one  SYNONYM  exists 
for  a  name,  they  are  listed  beneath  each  other. 

Options  and  Alternatives 

No  options  other  than  the  ORDER=ALPHA  and  ORDER=BYTYPE  features 
are  available  for  this  report. 

Analysis 

Each  name  in  the  data  is  inspected  and  its  name  type  and  any 
SYNONYMS  for  the  name  are  retrieved.  After  this  information  lias 
been  collected  for  all  names  in  the  data,  it  is  sorted  and 
presented  as  the  report. 

Usage 

The  report  is  intended  to  be  used  as  a  director  facility  by  anyone 
nreciiug  a  re!  er*  hoc  including  aii  name.::  o«'.  ined  in  t :  *  <  .*  data  base.. 
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Examples 


Figure  44  presents  the  NAME  LIST  report  generated  with  the 
ORDER-BYTYPE  option. 
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Figure  44  (Continued) 
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NAME  TYPE 


RELATIONSHIPS  DISPLAYED 


INTERFACE 

FLOW 

STRUCTURE 

DATA 

-  RECEIVES 

GENERATES 

-  PART  OF 

SUBPARTS  ARE 

-  RESPONSIBLE  FOR 

SET 

FLOW 

-  DERIVED 

UPDATED 

USED 

STRUCTURE 

-  SUBSET  OF 

SUBSETS  ARE 

• 

CONSISTS 

DATA 

-  RESPONSIBLE-INTERFACE 
SUBSETTING-CRITERIA 

INPUT  FLOW  -  GENERATED 

RECEIVED 

USED 

STRUCTURE  -  PART  OF 

SUBPARTS  ARE 

CONTAINED 

CONSISTS 


GENERATED 

DERIVED 

RECEIVED 

PART  OF 

SUBPARTS  ARE 

CONTAINED 

CONSISTS 


ENTITY  FLOW 


STRUCTURE 

DATA 


-  DERIVED 
UPDATED 
USED 

-  CONTAINED 
CONSISTS 

-  IDENTIFIED 


OUTPUT 


FLOW 


STRUCTURE  - 


•;  . ;  I  7 

'iypi'.'j  >  :..i  1.  • :  ii.  i  Pi.c.s.t.  l  ..-C  in  Pi  Cl'  ..  'port 
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NAME  TYPE 


RELATIONSHIPS  DISPLAYED 


GROUP/ELEMENT  . 

FI^)W 

-  DERIVED 

UPDATED 

USED 

USED  TO  DERIVE 

USED  TO  UPDATE 

STRUCTURE 

-  CONTAINED 

CONSISTS* 

DATA 

-  ASSOCIATED 

IDENTIFIED 

SUBSETTING-CRITERION 

PROCESS 

FLOW 

-  RECEIVES 

USES 

USES  TO  DERIVE 

USES  TO  UPDATE 

DERIVES 

GENERATES 

UPDATES 

MAINTAINS 

STRUCTURE 

-  PART  OF 

SUBPARTS  ARE 

UTILIZED  BY 

UTILIZES 

Table  7  (cont'd) 


*This  rol.it  •  .  i  ■  i  i »  on  i  v  .'<ojilies  to  OkutVS,  i.r-.  .m  Kll  ’!i'  i-’nnoi: 

CONSIST  of  anything. 
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General  PICTURE  Format  and  Limits  per  Page 


PICTURE 


Purpose 

The  PICTURE  report  presents  flow  and  structure  information  about 
the  problem  statement  in  a  graphical  format.  The  PICTURE  report 
provides  the  user  with  a  detailed  view  of  one  part  of  the  target 
system  description  (i.e.,  it  presents  all  flow  and  structure 
relationships  a  particular  name  has  with  other  names). 

Information  Presented 


The  PICTURE  report  can  be  produced  for  any  names  in  the  data  base 
of  the  following  name  types: 

INTERFACE  SET  INPUT  OUTPUT 

ENTITY  GROUP  ELEMENT  PROCESS 

The  information  presented  in  the  report  varies  depending  on 
which  name  type  the  report  is  produced  for  and  the  parameters 
used  when  generating  the  report.  For  each  name  type  the  FLOW, 
STRUCTURE  and  DATA  parameters  present  different  types  of  PSL 
relationships  as  retrieved  from  the  data  base.  Table  7  shows 
the  relationships  presented  for  each  name  type. 

Format 


The  PICTURE  report  is  generated  in  a  graphical  format.  The  basic 
template  for  the  format  is  shown  in  Figure  45  A  given  PICTURE 
report  describes  a  single  named  object. 

The  object  being  described  is  represented  by  a  rectangular  box 
printed  in  the  center  of  the  report  page.  All  named  objects 
related  to  the  center  object  are  also  represented  by  rectangular 
boxes  but  are  arranged  around  the  perimeter  of  the  page.  The  name 
type  (PROCESS,  ELEMENT,  etc.)  of  the  represented  object  is  printed 
along  the  top  line  of  each  box.  The  relationship  of  an  object 
(represented  by  one  of  the  perimeter  boxes)  with  the  center  object 
is  printed  along  the  bottom  line  of  the  box.  For  illustrative 
purposes,  lines  extend  from  each  box  to  the  center  box. 


H - GROUP - »- 

1  1 

H - PROCESS - + 

i  1 

H - ELEMENT- 

| 

- + 

| 

1  1 

i  gr-z  i 

|  | 

1 

X 

i  el-y 

i 

1 

| 

-i - USES - + 

H - h 

W - DERIVES- 

— + 

The  preceding  example  is  to  be  interpreted  as  follows: 

PROCESS  pr-x  USES  GROUP  gr-z  and, 

PROCESS  pr-x  DERIVES  ELEMENT  el-y. 

I 

Should  a  PICTURE  of  a  particular  name  exceed  the  page  limitation 
as  given  in  Figure  45 *the  PICTURE  will  be  continued  on  succeeding 
pages . 

The  format  of  the  relationships  presented  varies  depending  on  the 
name  type  of  the  object  being  described  (iust  as  the  types  of 
relationships  vary) .  See  Figures46_52H  on  how  relationships 
are  formatted. 

Options  and  Alternatives 


The  user  has  the  option  of  displaying  any  combination  of  the  three 
types  of  relationships  (DATA,  FLOW  and  STRUCTURE)  on  the  report. 

See  Table  7  for  which  relationships  are  displayed  in  each  of  these 
categories  for  a  particular  name  type.  For  example,  if  only  the 
CONSISTS  and  CONTAINED  information  (STRUCTURE)  were  to  be  displayed 
for  a  particular  ENTITY  name,  DATA  and  FLOW  relationships  could  be 
suppressed  via  the  NODATA  and  NOFLOW  parameters.  The  parameters 
allowed  and  their  effect  on  the  report  are  described  below: 


1. 

DATA 

-  specifies  that  data  type  relationships  be 
included  in  each  PICTURE. 

NODATA 

-  specifies  that  these  relationships  are  not 
included . 

2. 

FLOW 

-  specifies  that  flow  type  relationships  be 
included  in  each  PICTURE. 

NOFLOW 

-  specifies  that  these  relationships  are  not 
included. 

3. 

STRUCTURE 

-  specifies  that  structure  type  relationships 
be  included  in  each  PICTURE. 

NOSTRUCTURE 

-  specifies  that  these  relationships  are  not 
included. 

An  INDEX  for  the  report  is  produced  when  the  INDEX  parameter  is  used. 

The  report  may  be  generated  for  a  single  input  name  (via  the  NAME 
parameter)  or  for  a  collection  of  names  either  specified  by  the 
USER  or  retrieved  via  NAME-GEN. 


Analysis 

For  each  name  given  as  input  the  software  finds  the  name  in  the 
data  base.  If  the  name  is  not  found  the  message: 

URA066:  MAINPIC:  NAME  NOT  IN  D.B.  - 

Jr,  printed.  Tf  the  name  is  found  it  is  chocked  if  it  is  of  a 

legal  name  type  for  which  a  PICTURE  may  be  generated,  i*e.  a 
SET,  INPUT,  OUTPUT,  ENTITY,  GROUP,  ELEMENT,  PROCESS,  or  INTERFACE 
name.  If  it  is  not  one  of  these  name  types  the  message: 
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GROUP / ELEMENT  PICTURE 


4 

I 

to 

CO 

w 

o 

O 

Ph 

i 


W  M  W 


£ 

P 

P 

w 

M 


WWW 


H 

¥ 


|  H  H  H  | 

CO  pl 

co  ,  o 

w 

O  H 

9  P* 

< 

w  p 

Ihhh  j 


4 

CO 

w 

H 


|  H  H 

I 

e 

8  e 

I  H  H  H  ^ 


t 


WWW 


W 


I 


4  W  W  W 


w 


(U 
H  H 
W  P 


H* 

52 

14 


t 


CO 

w 

> 


os 

w 


WWW 


CO 

CO 

w 

o 

o 

P 


t 


WWW 


■l 


W  W  W  4 


t 

4 

w 

M  H 

<  4 

1 

CO 

f 

H* 

i 

>< 

52 

1 

t> 

H 

H 

p 

i4 

CO 

w 

P 

w 

p 

w 

w 

H 

pH 

w 

o 

fU 

00 

o 

W 

52 

55 

fii 

*4 

p 

P4 

Pi 

r 

M 

W 

c: 

:o, 

1 

4  W  W  W 


t 


M  W  H 


O  Wj  P 

wwh| 

CO 

CO 

CO 

w 

w 

M 

o 

W 

•  o 

P 

• 

P 

w 

P 

H 

| 

b 

•  4*  H 

w  w  + 

4  W  W  W 


52 

O 


H 

lM 


I 

I 

52 

O 

CO 

CO 

I 


4 


4k 

M  pD 
H  H  O 
W  52  P* 
CO  W  O 

L- L 


H 

52 


T 


PJ 

W 

iiJ 


t 


co 

CO 

W 

o 

o 

Pi 


l 


WWW 


+ 

CO 

55 


$ 

52 

M 


Fhhh  + 


WWW 


t 


CO 

W 

H 

< 

P 

P 

P 


W'W  M 


-J- 


WWW 


t 


CO 

u 

2$ 

P 

P 

CO 

4 


PROCESS  PICTURE 


URA067:MAINPIC:  PICTURE  NOT  AVAILABLE  FOR  - 


is  printed.  If  the  name  is  of  a  legal  name  type  it  is  then  checked 
if  any  of  the  relationships  that  can  be  presented  in  the  PICTURE 
for  that  name  type  exist  for  the  particular  name.  If  none  of 
these  relationships  exist,  the  message: 

URA289 : PCLRBT :  NO  PICTURE  AVAILABLE  FOR 

is  printed.  Otherwise,  those  relationships  available  for  the 
name  are  presented  in  the  report. 

Usage 

Project  management  can  use  this  report  to  gain  a  basic  understanding 
of  the  functions  of  the  target  system  by  viewing  PICTURES  of  high 
level  target  system  objects. 

PICTURES  provide  a  good  means  of  communication  among  people  in  the 
project  and  those  external  to  it.  A  graphical  format  is  often 
easier  to  interpret  than  a  matrix,  narrative  text,  etc. 

Problem  Defincrs  may  use  the  PICTURE  report  to  visually  analyze  the 
description  of  particular  objects  to  check  for  completeness.  For 
each  type  of  name  (e.g.,  PROCESS  or  ELEMENT)  several  checks  can  be 
made  depending  on  the  relationships  presented  in  the  report.  Table 
8  presents  completeness  checks  that  can  be  made  by  visually 
scanning  PICTURE  reports. 

Examp  .1  es 

Figure  53  presents  a  PICTURE  for  an  INPUT  name  "time¬ 
card." 

Figure  54  presents  a  PICTURE  for  an  INTERFACE  name  "employee." 

Figure  55  presents  a  PICTURE  for  a  PROCESS  name  "hourly- 

cr.iployee-processing. "  This  example  was  produced  by  giving  the 
following  Analyzer  command: 

PICTURE  NAME=hourly- employee-processing 
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INTERFACE  An ‘INTERFACE  should  RECEIVE  an  OUTPUT,  GENERATE  an 

INPUT  and/or  be  RESPONSIBLE  for  a  SET. 


SET  A  SET  should  be  USED  by  a  PROCESS,  DERIVED  BY  A  PROCESS, 

and/or  be  UPDATED  by  a  PROCESS. 

A  check  can  also  be  made  that  the  SET  has  a  RESPONSIBLE- 
INTERFACE. 

If  the  SET  has  SUBSETS,  it  should 
also  have  SUBSETTING— CRITERIA. 


INPUT  An  INPUT  should  be  RECEIVED  by  a  PROCESS  and  GENERATED 

by  an  INTERFACE.  An  INPUT  should  also  be  USED  bv  a  PF'CEI: 

OUTPUT  An  OUTPUT  should  be  GENERATED  by  a  PROCESS  and  RECEIVED 

by  an  INTERFACE.  An  OUTPUT  should  also  be. DERIVED  by  a 
PROCESS. 


ENTITY  An  ENTITY  should  be  USED  by  a  PROCESS,  DERIVED  by  a 

PROCESS,  and/or  be  UPDATED  by  a  PROCESS. 

A  check  can  also  be  made  that  the  ENTITY  is  IDENTIFIED 
by  a  GROUP  or  ELEMENT. 


ikOUP/ ELEMENT 


A  GROUP/ELEMENT  should  be  USED  by  a  PROCESS,  DERIVED  bv 
a  PROCESS,  and/or  be  UPDATED  by  a  PROCESS. 


A  check  can  be  made  that  the  GROUP/ELEMENT  may  IDENTIFY 
An  ENTITY,  be  SUBSETTING -CRITERION  for  a  SET  and/cr  be 
ASSOCIATED  with  a  RELATION. 


■'ROCESS 


A  PROCESS  should  RECEIVE  an  INPUT,  GENERATE  an  OUTPUT, 
USE  a  SET,  ENTITY,  INPUT ,  GROUP  or  ELEMENT,  DERIVE  a 
SET,  OUTPUT,  ENTITY,  GROUP  or  ELEMENT,  UPDATE  a  SET, 
ENTITY,  GROUP  or  ELEMENT,  and/or  MAINTAIN  a  RELATE ON 


Table  8 


Completeness  Checks  that  may  be  made  by  usinp  the  PICTURE  report. 
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PROCESS  CHAIN  REPORT 


Purpose 

To  present  in  a  graphical  format  the  sequence  of  EVENTS  and  PROCESSES 
which  occurs  as  a  result  of  each  EVENT  or  PROCESS  specified  as  input. 

Information  Presented 


For  each  EVENT  name  given  as  input  to  the  software  producing  the 
report,  the  report  presents  all  PROCESS  names  which  the  EVENT  TRIGGERS. 
For  each  of  these  PROCESS  names  presented  the  report  presents  all 
EVENTS  occurring  ON-INCEPTION  or  ON-TERMINATION  of  the  PROCESS.  The 
report  then  presents  all  the  PROCESSES  which  these  EVENTS  TRIGGER, 
etc. ,  and  the  network  continues  until  a  loop  is  encountered  or  no  more 
relationships  are  found. 

For  each  PROCESS  name  given  as  input  to  the  software  producing  the 
report,  the  report  presents  all  EVENTS  occurring  ON-INCEPTION  or  ON- 
TERMINATION  of  the  PROCESS.  For  each  of  these  EVENT  names  presented 
the  report  presents  all  PROCESS  names  which  the  EVENT  TRIGGERS.  The 
report  then  presents  all  the  EVENTS  occurring  ON-INCEPTION  or  ON- 
TERMINATION  of  the  PROCESS,  etc.,  and  the  network  continues  until  a 
loop  is  encountered  or  no  more  relationships  are  found. 

Format 


Each  name  which  appears  on  the  output  is  shown  within  a  box.  The  top 
line  of  the  box  indicates  the  name  type  (EVENT  or  PROCESS) ,  while  the 
bottom  line  shows  the  relationship  with  the  preceding  EVENT  or  PROCESS 
(TRIGGERED,  ON- INCEPTION,  ON-TERMINATION).  Boxes  containing  related 
names  are  linked  by  dotted  lines. 

If  a  name  joins  two  or  more  chains  (strings  of  related  names)  into  a 
loop  or  loops,  every  appearance  of  that  name  after  the  first  will  be 
linked  to  a  box  containing  the  message,  "LOOPS  TO  PREVIOUS  ENTRY. M 

Output  is  continued  across  page  boundaries.  If  the  right  edge  of  one 
page  continues  to  the  left  edge  of  a  second,  the  righraost  column  of 
boxes  on  the  first  page  will  be  repeated  as  the  leftmost  column  of 
boxes  on  the  second  page,  in  order  to  facilitate  matching  of  edges. 
Similarly,  if  the  bottom  edge  of  one  page  continues  to  the  top  edge 
of  a  second,  the  bottom  row  of  boxes  on  the  first  page  will  be  repeated 
as  the  top  row  of  boxes  on  the  second  page. 

Options  and  Alternatives 

The  report  may  be  generated  for  a  single  EVENT  or  PROCESS  name  (via 
the  NAME  parameter)  or  for  a  collection  of  such  names,  either  input 
by  the  user  or  obtained  by  use  of  NAME-GEN. 
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The  number  of  columns  and  rows  used  on  the  page  may  be  decreased 
from  their  default  values  of  119  and  39,  respectively,  via  the 
COLUMNS  and  ROWS  parameters.  The  minimum  acceptable  values  for 
COLUMNS  and  ROWS  are  38  and  14,  respectively. 

The  number  of  boxes  arranged  horizontally  or  vertically  on  a  page 
may  be  decreased  from  the  defaults,  which  are  the  maximum  numbers 
that  will  fit  in  each  direction  (depending  on  COLUMNS  and  ROWS) , 
in  order  to  make  the  output  less  cluttered.  The  parameters  which 
can  be  used  to  do  this  are  HORIZONTAL-BOXES  and  VERTICAL-BOXES. 

Their  maximum  values  (for  C0LUMNS=119  and  ROWS»39)  are  6.  Due  to 
the  scheme  for  continuing  pages,  their  minimum  values  are  2. 

The  number  of  connections  to  be  traced,  starting  at  the  given  name, 
may  be  set  at  any  positive  value  via  the  LINKS  parameter.  The  same 
LINKS  value  is  used  for  all  names  input  when  the  FILE  parameter  is 
used. 

An  index,  containing  each  name  used  on  the  report  and  the  page(s)  on 
which  it  appears,  may  be  obtained  by  specifying  the  INDEX  parameter. 

Analysis 

Each  name  given  as  input  is  first  checked  to  see  that  it  is  in  the 
data  base  and  that  it  is  either  a  PROCESS  or  EVENT  name.  If  the  name 
is  not  in  the  data  base,  the  message 

URA360:  FILMAT:  NAME  NOT  IN  DATA  BASE 

will  be  given.  If  the  name  is  of  a  type  other  than  PROCESS  or  EVENT, 
the  user  will  receive  the  message 

URA361:  FILMAT:  NAME  NOT  EVENT  OR  PROCESS. 

If  the  name  passes  these  two  tests,  it  is  placed  in  a  data  structure 
which  will  later  be  used  for  output.  The  name  is  then  used  to  generate 
a  tree  structure  of  PROCESSES  and  EVENTS  as  follows.  If  the  name  is 
an  EVENT,  all  PROCESSES  which  it  TRIGGERS  are  retrieved  from  the  data 
base  and  placed  on  a  stack.  Then,  the  first  name  is  removed  from  the 
stack,  placed  in  its  proper  location  in  the  data  structure,  and  all 
EVENTS  occurring  ON-INCEPTION  or  ON-TERMINATION  of  that  PROCESS  are 
retrieved  and  placed  on  the  stack.  This  procedure  continues,  with 
names  being  removed  from  the  top  of  the  stack,  placed  in  the  data  structure, 
and  used  to  obtain  further  names,  which  are  then  placed  on  the  stack. 

At  any  stage  of  this  procedure,  no  names  will  be  put  on  the  stack  if 
one  of  the  following  is  true: 

1.  The  current  name  is  an  EVENT  which  TRIGGERS  no  PROCESSES, 
or  a  PROCESS  which  has  no  EVENTS  occurring  ON-INCEPTION 
or  ON-TERMINATION. 

2.  The  current  name  has  been  encountered  earlier,  and  is 
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therefore  at  the  end  of  a  chain  or  forms  a  loop  with 
some  portion  of  a  chain  traced  earlier. 

3.  The  number  of  links  that  has  been  traced  on  the  current 
chain  is  equal  to  the  limit  set  by  the  LINKS  parameter. 

(For  every  input  name  for  which  this  occurs,  the  message 

URA364:  FILMAT:  LINK  LIMIT  SPECIFIED  WAS  REACHED 

will  be  printed.) 

Thus,  in  any  of  these  cases,  the  size  of  the  stack  will  decrease. 

The  entire  procedure  is  complete  when,  after  any  search,  the  stack 
is  empty.  If  the  name  input  is  a  PROCESS  name,  the  first  search  is 
for  EVENTS  occurring  ON-INCEPTION  or  ON-TERMINATION  of  that  PROCESS. 

From  there,  the  procedure  is  identical  to  that  described  above. 

The  data  structure  constructed  from  all  names  found  as  above  is  broken 
into  page-sized  units  and  is  printed  a  page  at  a  time. 

The  process  described  above  is  repeated  until  no  more  names  remain 
in  the  input  stream. 

Usage 

The  PROCESS  CHAIN  report  presents  a  comprehensive  view  of  the  dynamic 
behavior  of  the  PROCESSES  within  the  target  system  for  inclusion  in 
the  final  specifications  of  the  system  or  as  an  aid  in  communicating 
this  information  to  others. 

Programmers  and  System  Designers  in  particular  will  find  this  report 
helpful  in  identifying  and  optimizing  the  system  logic.  If  the  PROCESSES 
are  defined  to  the  level  of  computable  statements,  the  PROCESS  CHAIN 
report  will  essentially  chart  out  the  program  logic. 

Problem  Definers  may  use  the  PROCESS  CHAIN  report  to  visually  analyze 
the  description  of  particular  objects  and  the  system  as  a  whole,  for 
completeness.  Table  9  presents  completeness  checks  that  can  be  made 
by  visually  scanning  PROCESS  CHAIN  reports. 

Example 


Figure  56  presents  a  PROCESS  CHAIN  for  the  EVENT  "salaried-emp- 
processing-unit . " 
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PROCESS 

The  absence  of  any  EVENT  as  a  result  of  INCEPTION 
or  TERMINATION  of  the  PROCESS  should  be  rationalized. 

EVENT 

The  absence  of  any  PROCESS  being  TRIGGERED  by  an 

EVENT  should  be  rationalized. 

System 

Description 

All  chains  should  terminate  in  one  of  three  ways: 

1)  In  a  loop  back  into  the  chain 

2)  By  a  PROCESS  designating  the  last  activity 

in  the  procedure  represented  by  the  chain 

3)  By  an  EVENT  designating  termination  of  a 
procedure  represented  by  a  chain 

Given  a  particular  PROCESS  or  EVENT,  the  report 
allows  a  trace  to  be  made  through  the  system  of 
actions  taken.  Checks  can  be  made  that  based  on 
a  particular  starting  point  all  EVENT-PROCESS 
chains  evolving  from  the  starting  point  terminate 
correctly. 

Table  $ 

Completeness  Checks  that  may  be  made  by 
Visual  Analysis  of  the  PROCESS  CHAIN  Report 
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Figure  56  (Continued) 


PROCESS  INPUT/OUTPUT 


Purpose 

To  present  in  an  easy  to  examine  outline  form,  the  basic  functions 
of  one  or  more  PROCESSES  in  the  Language  description  and  how  these 
PROCESSES  interact  with  information. 

Information  Presented 

The  report  presents,  for  the  PROCESS  names  given  as  input,  four  types 
of  information  which  may  be  printed  or  suppressed  by  the  speci¬ 
fication  of  appropriate  parameters  for  the  command  generating  the 
report. 

The  DESCRIPTION  parameter  permits  the  printing  of  the  DESCRIPTION 
comment  entry  for  each  PROCESS  if  available.  The  PROCEDURE  para¬ 
meter  permits  the  printing  of  the  PROCEDURE  comment  entry  for 
each  PROCESS  if  available. 

The  INPUT  parameter  permits  the  printing  of  the  names  of  all  SETS, 
INPUTS,  ENTITIES,  GROUPS  and/or  ELEMENTS  that  are  RECEIVED  and/or 
USED  by  each  PROCESS.  The  OUTPUT  parameter  permits  the  printing 
of  the  names  of  all  SETS,  OUTPUTS,  ENTITIES,  GROUPS  and/or  ELEMENTS 
that  GENERATED,  UPDATED  and/or  DERIVED  by  each  PROCESS. 

Format 


An  entry  in  the  report  is  printed  for  each  PROCESS  name  given  as 
input.  Each  name  is  identified  by  a  number,  1*,  2*,  etc.  desig¬ 
nating  its  position  in  the  input  stream.  The  following  format  is 
used  to  print  out  information  about  each  process: 

if*  process  name 

[DESCRIPTION  comment  entry] 


[PROCEDURE  comment  entry] 

***  INPUTS  *** 

[All  INPUTS  RECEIVED  by  the  PROCESS] 

[All  SETS,  INPUTS,  ENTITIES,  GROUPS  and  ELEMENTS 
USED  by  the  PROCESS] 

***  OUTPUTS  *** 


[All  OUTPUTS  GENERATED  by  the  PROCESS] 


[AT]  SETS ,  OUTPUT'S ,  ENTITIES.  GROUT>f,  rnd  ELEMENTS 

DERIVED  by  the  PROCESS] 


[A’.  J.  SETS  ENTI 
by  the  PROCESS'] 


GROUPS 


and  ELEMENTS  UPDATED. 
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All  the  names  listed  under  the  INPUTS  and  OUTPUTS  headings  are 
numbered  sequentially. 

If  a  DESCRIPTION  or  PROCEDURE  comment  entry  is  not  available  for 
a  particular  name,  that  part  of  the  format  is  not  included  in  the 
report.  If  no  names  are  listed  under  the  INPUTS  heading,  the 
message: 


NO  INPUTS  FOR  THIS  PROCESS 

will  be  printed.  If  no  names  are  listed  under  the  OUTPUTS  heading, 
the  message: 


NO  OUTPUTS  FOR  THIS  PROCESS 
will  be  printed. 

Options  and  A3  ternatives 

Any  part  of  the  information  presented  for  each  PROCESS  name  can  be 
included  in  or  omitted  from  the  report  depending  on  the  parameters 
used  when  generating  it:  The  parameters  and  their  effect  on  the 
report  are  given  below. 

1.  DESCRIPTION  -  specifies  that  the  DESCRIPTION  comment  entry  for 

each  name  be  included  in  the  report. 

NODESCRIPTION  -  specifies  that  the  comment  entry  is  not  printed. 

2.  PROCEDURE  -  specifies  that  the  PROCEDURE  comment  entry  for  each 

name  be  included  in  the  report. 

NOPROCEDURE  -  specifies  that  the  comment  entry  is  not  printed. 

3.  INPUT  -  specifies  that  names  USED  or  RECEIVED  by  the  PROCESS 

are  presented  in  the  report. 

NOINPUT  -  specifies  that  those  names  are  not  printed. 

A.  OUTPUT  -  specifies  that  names  DERIVED,  UPDATED  or  GENERATED 
by  the  PROCESS  are  presented  in  the  report. 

NOOUTPUT  -  specifies  that  these  names  are  not  printed. 

Each  entry  of  the  report  is  started  at  the  beginning  of  a  new  page 
when  the  MEW-PAGE  parameter  is  specified.  When  KONEV,'- PAGE  is  in 
effect,  the  entries  are  printed  one  after  another  in  the  report. 

An  INDEX  for  the  report  is  produced  when  the  INDEX  parameter 
is  specified. 


The  report  may  be  generated  for  a  single  name  (via  the  name  parameter) 
°r  ^N”5E  names  each  specified  by  the  user  or  retrieved 
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#  \ 
Each  name  given  as  input  to  the  software  producing  the  report  is 
searched  for  in  the  data  base.  If  it  is  not  found  the  message: 

URA076:  MAINPRIO :  NAME  NOT  IN  DATA  BASE  - 

is  printed.  If  it  is  found  a  check  is  made  that  it  is  a  PROCESS 
name.  If  it  is  not,  the  message: 

URA088:  MAINPRIO:  NAME  NOT  A  PROCESS  NAME  - 

is  printed.  If  the  name  is  a  PROCESS  name  then  the  information 
available  for  it,  as  requested  by  the  parameters,  is  presented  on 
the  report. 

Usage 


This  report  is  beneficial  in  presenting  a  general  description  of  the 
functions  of  target  system  (as  described  by  the  PROCESS)  for  purposes 
of  communication  between  analysts  and  users. 

It  may  also  be  used  by  analysts  to  check  that  the  DESCRIPTION  and 
PROCEDURE  defined  for  each  PROCESS  is  in  agreement  with  the  in¬ 
formation  which  is  input  to  or  output  from  the  PROCESS. 

Examples 

Figure  57  presents  a  PROCESS  INPUT/OUTPUT  report  for  a  single 
name  "payroll-processing." 

Figure  58  presents  the  report  generated  for  the  SUBPARTS  of 
"payroll-processing."  This  was  done  by  the  following  commands: 

NAME-GEN  SUBPARTS-OF«payroll-processing  LEVELS -1 
PROCESS-INPUT- OUTPUT  PROCEDURE 
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PUNCHED  COMMENT  ENTRIES 


Purpose 

To  present  selected  comment  entries  given  for  one  or  more  names  in 
a  particular  data  base. 

Information  Presented 

The  report  presents,  for  those  names  given  as  input,  any  comment 
entries  which  are  specified  as  parameters  and  are  available  for 
the  names.  The  types  of  comment  entries  available  for  each  name 
are  dependent  on  the  name  type  of  the  name  the  report  is  being 
generated  for.  The  table  below  shows’  the  types  of  comment  entries 
that  may  be  presented  and  the  types  of  names  they  may  be  presented  for. 


Comment  Entry  Type _ Name  Type 


DESCRIPTION 

All  name  types 

PROCEDURE 

PROCESS 

VOLATILITY 

ENTITY 

VOLATILITY-MEMBER 

SET 

VOLATILITY-SET 

SET 

DERIVATION 

RELATION  and  SET 

TRUE-WHILE 

CONDITION 

FALSE-V.T1ILE 

CONDITION 

Format 


An  entry  in  the  report  is  printed  for  each  comment  entry  presented 
for  each  name  given  as  input.  Each  entry  is  numbered  1*,  2*,  etc. 

The  format  of  each  entry  is: 

//*  name 

comment-entry-statement; 

[comment  entry  text]; 

Each  line  of  the  comment  entry  text  is  numbered  within  a  given  report 
entry. 

Options  and  Alternatives 

An  entry  in  the  report  is  produced  for  each  comment  entry  (as  spe¬ 
cified  by  the  parameters  for  the  command  generating  the  report)avail- 
able  for  each  name  given  as  input.  The  following  parameters  desig¬ 
nate  the  comment  entries  to  be  presented: 


DERIVATION 
PFOCEDIDm.-  ' 

VOLATILITY-MEMBER 


DESCRIPTION  FALSE-l.’HILE 

TPUE-VWI I  F  V01  A’m  tty 

VOLATILITY  SET 


Any  o'  those  paramet  ers  preij 
n’vrc'ym.'h'n'',  c"  •  iT.t  ontXi*~5’. 


i.‘j  with  "NO"  spec j.i'.'.es  that  the  • 
a  ye  not  to  he  p-c  r  -  r.'  ’  in  the  re- 
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Analysis 


Each  name  given  as  input  to  the  software  generating  the  report 
is  searched  for  in  the  data  base.  If  it  is  not  found  the  message: 

URAL35:  MAINPCOM:  NAME  NOT  FOUND  IN  D.B.  - 

is  printed.  If  the  name  is  found  then  those  comment  entries  (as 
specified  by  the  parameters)  which  are  available  for  it  are  printed 
on  the  report. 

Usage 

The  report  may  be  used  by  analysts  to  check  the  availability  of 
specific  types  of  comment  entries  for  a  class  of  names.  For  ex¬ 
ample,  to  check  that  all  SETS  have  VOLATILITY-MEMBER,  VOLATILITY- 
SET,  and  DERIVATION  comment  entries  the  commands: 

NAME-GEN  SET 

PUNCH- COMMENT- ENTRY  VOLATILITY-MEMBER  VOLATILITY- SET  DERIVATION 


can  be  given. 

Examples 

Figure  59  presents  the  report  for  the  name  "salaried- employee- 
processing." 
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STRUCT  URE' 


Purpose 

To  present  the  implied  hierarchy  of  PROCESSES,  or  INPUTS,  or 
OUTPUTS  or  INTERFACES  defined  in  the  Analyzer  data  base,  from 
the  use  of  the  SUBPARTS  statements  relating  them. 

Information  Presented 


The  report  presents  all  SUBPARTS  structures  for  a  given  class  of 
names  (INTERFACES,  INPUTS,  OUTPUTS,  or  PROCESSES)  as  specified 
by  the  parameters  when  generating  the  report. 

The  structures  start  with  all  names  which  are  not  PART  of  any 
higher  structure.  These  names  are  designated  level  1  names. 

The  SUBPARTS  of  level  1  names  are  presented  as  level  2  names. 

The  SUBPARTS  of  the  level  2  names  are  then  presented  and  so  on. 


Format 


The  report  presents  the  structures  under  three  headings:  COUNT,  LEVEL, 
and  NAME .  NAME  presents  the  name  of  the.  object  in  the  structure,  LEVEL 
presents  the  level  number  associated  to  the  name  corresponding  to  its 
position  in  the  structure  and  COUNT  presents  the  position  (line)  in 
the  report  where  the  name  is  printed  out.  Each  level  is  indented  (as 
specified  by  the  INDENT  parameter)  to  further  accent  the  idea  of 
structure. 

A  summary  section  for  the  report  provides  a  count  (under  the  COUNT 
heading)  of  the  number  of  names  presented  at  a  given  level  (as  desig¬ 
nated  by  the  LEVEL  heading) . 

Options  and  Alternatives 

The  INPUT,  OUTPUT,  PROCESS  and  INTERFACE  parameters  for  the  conxiand 
specify  which  type  of  names  the  report  \fill  be  produced  for.  One 
and  only  one  of  these  parameters  may  be  specified  for  the  command 
producing  the  report. 

.  The  number  of  spaces  which  each  level  of  the  structure  is  indented 
may  be  assigned  by  the  INDENT  parameter.  If  no  value  is  given  INDENT 
defaults  to  3,  but  may  take  on  any  value  from  1  to  10. 

An  INDEX  for  the  report  is  produced  when  the  INDEX  parameter  is  used. 

Analysis 

A  check  is  made  that  at  least  one  name  (of  the  name  type  designated 
by  the  parameters)  exists  in  the  data  base  which  is  not  PART  of  a 
larger  structure.  If  no  such  name  exists  the  message: 

URA  288:  STATPS:  No  name  at  level  one 
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is  printed.  For  each  name  found,  its  SUBPARTS  structure  is  traced  and 
presented  in  the  report. 

If  a  loop  is  encountered  in  the  structure  the  message: 

URA  285:  ERRPS:  THE  FOLLOWING  NAMES  ARE  INVOLVED  IN  LOOPS  - 
is  printed  with  the  names  involved. 

Should  the  structure  consist  of  more  than  50  levels  (the  limit  that 
the  software  has  been  designed  to  handle)  the  message: 

URA  284:  MAINSTR:  TOO  MANY  LEVELS  -  CONTINUING  - 

is  printed. 

Usage 

The  report  is  an  aid  to  analysts  in  maintaining  consistency  in 
structures  defined  for  the  target  system  description.  Especially 
where  a  top-dovm  approach  is  being  used,  the  analyst  is  concerned 
that  names  have  been  inserted  into  the  proper  level  of  a  structure. 

Examples 

Figure  60  presents  a  STRUCTURE  report  for  INPUT  names.  Figur*.  6l, 
62  and  63  present  STRUCTURE  reports  for  OUTPUT,  INTERFACE  and  PROCESS 
names,  respectively. 
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Figure  63  (Continued) 


INDEX 


Purpose 

To  provide  a  reference  into  a  particular  URA  report  to  locate  all 
occurrences  of  the  use  of  a  particular  user  defined  name  in  the 
report. 

Information  Presented  . 

The  report  presents  all  the  user  defined  names  used  in  a  given  URA 
report,  which  must  be  one  of  the: 

CONTENTS  REPORT 

DICTIONARY  REPORT 

EXTENDED  PICTURE 

FORMATTED  PROBLEM  STATEMENT 

PICTURE 

PROCESS  CHAIN 

PROCESS  IKPUT/OUTPUT  or 

STRUCTURE,, 

the  page  numbers  in  the  report  where  each  name  occurs,  and  the  number 
of  times  the  name  appears  within  the  pages  it  occurs  (if  more  than 
once) . 

Format 


The  report  consists  of  an  entry  for  each  name  used  in  one  of  the  above 
reports  The  entry  consists  of: 

-the  name  presented  in  the  report 

-the  page  numbers  (separated  by  commas)  that  the  name  occurs 
on  in  the  report 

-the  number  of  occurrences  (enclosed  in  brackets)  of  the  name 
on  a  particular  page. 

Each  entry  is  numbered  and  the  entries  are  arranged  in  alphabetical 
order  by  name. 

Options  and  Alternatives 

There  are  no  options  for  this  report. 

Analysis 

The  input  for  the  software  producing  the  INDEX  is  obtained  from  one 
of  the  report-producing  modules  which  allow  the  INDEX  parameter.  If  no 
input  is  available,  because  the  report  presents  no  information,  the 

message : 


URA  ,  /:  ::  i 

i  r,  pi":  ,it.  c  ,1 .  If  ’  '•,!.>  (i:-  1 1  •  •  fi-jrt  <;f  ;  ;  ;  ,--.Tld  ]  j  r.« 

numbers)  the  names  are  sorted  and  presented  as  the  index  report. 


284 


Usage 


The  INDEX  is  intended  as  a  reference  into  a  report  for  purpose 
of  locating  all  occurrences  of  the  use  of  a  particular  name  in 
the  report.  The  INDEX  is  usually  desirable  whenever  a  report  over 
a  few  pages  in  size  is  to  be  generated. 

Examples 


Figure  64  presents  a  PROCESS  INPUT/OUTPUT  REPORT  with  an  INDEX. 
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A  Note  on  Version  A2.1  of  URA 


There  are  several  important  changes  that  have  been  made  in  URA  which 
makes  Version  A2.1  different  than  Version  A2.0. 

■/ 

First,  several  internal  modifications  (which  are  transparent 'to  the 
user)  have  been  made  to  make  the  URA  more  efficient.  Second  a  few 
errors  in  Version  A2.0  have  been  corrected  so  that  the  URA  commands 
perform  properly.  Third,  the  availability  of  a  select  number  of 
URA  commands  and  parameters  have  been  removed.  Last,  two  new  commands 
are  available  in  this  version,  and  some  commands  have  additional  para¬ 
meters  not  available  in  Version  A2.0. 

The  following  is  a  list  of  all  modifications  that  fall  into  the  latter 
two  classes  of  changes: 

1)  The  DATA-BASE-STATISTICS  command  has  been  removed  from  the  URA 
command  language,  but  is  still  available  as  a  stand-alone  program. 

2)  The  PUNCH/NOPUNCH  and  EMPTY/NOEMPTY  parameters  are  no  longer 
operative  for  the  PROCESS-INPUT-OUTPUT  command. 

3)  The  following  parameters  are  now  available  for  the  DATA-PROCESS 
command:  DPMAT/NODPMAT ,  DPANL/NODPANL ,  PMAT/NOMAT,  and  PANL/NOPANL. 

4)  The  PROCESS-CHAIN  and  EXTENDED-PICTURE  commands  have  been  added. 


* 
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The  URA  Command  Language 


The  URA  Command  Language 

Report  Commands 
Modifier  Commands 
Control  Commands 

Report  Commands  retrieve  data  from  the  URA  data  "base  and  output  it  in 
some  meaningful  format.  These  reports  do  not  change  the  contents  of 
the  data  "base  whatsoever.  Their  purpose  is  solely  that  of  displaying 
orderings  and/or  relationships  within  the  current  problem  statement. 
The  following  Report  Commands  are  available  in  this  version  of  the 
Analyzer: 

CONSISTS-COMPARISON 

CONSISTS-MATRIX 

_ CONTENTS 

DATA-PROCESS 

DICTIONARY 

ENTITY-IDENTIFIER  : 

EXTENDED-PICTURE  ..  _  _ 

PORMATTED-PROBLEM-STATEMENT 

FREQUENCY 

KWIC 

NAME-GEN 

NAME-LIST 

PICTURE 

PRINT-ATTRIBUTE- VALUES 

PROCESS-INPUT-OUTPUT 

PROCESS-CHAIN 

PUNCH-COMMENT-ENTRY 

STRUCTURE 

SUMMARY 

Modifier  Commands  are  intended  to  modify  the  contents  of  the  URA  data 
base  in  the  manner  defined  by  the  problem  definer.  These  commands 
take  legal  URL  statements  orURL  names  as  input.  URA  then  generates 
error  diagnostics  as  well  as  an  output  report  to  present  the  outcome 
of  the  data  base  alteration.  The  following  Modifier  Commands  are 
available  in  this  version  of  the  Analzyerj 

CHANGE-TYPE 

DELETE 

DELETE-COMMENT-ENTRY 

DELETE-PSL 

INPUT-PSL 

RENAME 

REPLACE-COMMENT-ENTRY 


consists  of  three  basic  types  of  commands: 

f 


Control  Commands  are  the  means  to  pass  certain  control  information  to 
the  User  Requirements  Analyzer.  The  SET  command,  for  example,  allows 
the  user  to  define  which  URA  data  base  is  to  be  accessed  by  the  Report 
and  Modifier  Commands  as  well  as  setting  various  switches  and  assigning 
input  and  output  lilos.  Control  Commands  are  installation  dependent 
and  therefore  are  given  in  the  Appendix  E 
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Although  any  of  the  commands  can  be  Issued  independently  of  each 
other,  it  is  often  advantageous  to  use  some  commands  in  sequence. 

This  means  that  output  of  one  command  can  be  used  as  input  by  another. 
The  most  common  instance  of  this  is  when  NAME-GEN  is  used  to  select 
certain  names  (say  all  PROCESSES  for  example)  which  can  then  he  used 
as  input  to  a  Report  Command  (possibly  PICTURE,  for  a  PICTURE  REPORT 
for  all  PROCESS  names.) 


-  URA  Command  Language  /Installation  De-pendencies 

URA  is  a  software  system  that  is  designed  to  be  used  interactively 
in  a  time  sharing  system  environment.  It  contains  its  own  data 
base  management  system  but  it  is  dependent  on  the  time  sharing 
operating  system  for  the  usual  facilities  of  sign  on,  identification 
and  security,  file  creation  and  editing,  etc. 

Differences  in  operating  systems  and  operations  at  particular  instal¬ 
lations  affect  the  way  in  which  URA  is  executed  at  a  particular 
installation.  There  are  basically  three  aspects  of  ura  that  axe 
installation  "dependent": 

1)  Control  commands 

2)  Method  of  initiating  and  executing  URA 

3)  File  names  used  by  URA 

These  dependencies  are  presented  in  Appendix  E  for  the  particular 
installation. 

URA  can  also  be  used  in  batch  mode  at  most  installations.  The  commands 
necessary  to  accomplish  this  are  also  installation  dependent  and  are 
not  covered  in  this  paper. 
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Command  Language  Syntax  Notation 


ABBREVIATIONS 


To  enable  the  user  to  fit  a  lengthy  command  on  the  allotted  line  and 
eliminate  some  of  the  tedium  of  command  specification,  abbreviated 
forms  for  both  commands  and  parameters  may  be  used.  Each  abbreviation 
can  be  found  in  parentheses  immediately  following  the  word  it  represents. 
For  example,  the  command: 


CHANGE-TYPE  NAME=GROSS-PAY  TYPE= ELEMENT  can  be  written  as 


CT  '  N=GROSS-PAY  T=ELEMENT 


BLANKS 

A  blank  must  appear  between  the  command  and  any  accompanying  parameter, 
and  between  successive  parameters.  Several  blanks  are  treated  as  a 
single  blank  and  may  be  inserted  whenever  a  single  blank  is  necessary. 

For  example, 

CT  N= GROSS -PAY  T=ELEMENT  can  be  written  as 
CT  N=GROSS  -PAY  T=ELEMENT 

BRACES 

In  the  following  examples ,  when  parameters  or  parameter  values  are 
enclosed  in  braces  ({  }),  a  choice  among  the  two  or  more  entries  must 
be  made.  It  is  important  to  note  that  one  and  only  one  of  the  options 
must  be  chosen.  For  example,  the  braces  used  in  describing  the  syntax 
of  the  CHANGE-TYPE  command  specifies  that  the  command  must  either 

be  of  the  form: 

CT  N=user-name  T=name-type 

or 

CT  F=fdname  [T=name-type] 

•  BRACKETS 

Whenever  parameter  notation  in  an  example  appears  within  brackets  ( [  ] ) , 
it  indicates  a  feature  the  user  may  optionally  use.  For  example,  the 
TYPE  parameter  in  the  CHANGE-TYPE  command  is  optional  when  the  FILE 
parameter  is  also  used.  Therefore,  the  command  may  be  of  the  form; 


CT  FILE=fdname  TYPE=nane-type 
or 

CT  FILE=fdname 
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The  syntax  of  the  FILE  parameter  shows  that  the  parameter  may  be  given 
either  as: 

FILE=fdname 
or  just 

FILE 

No  other  variations  are  acceptable  (except  those  already  specified, 
i.e.,  abbreviations,  etc.). 

COMMAND  LINE 

Each  command  must  appear  on  a  separate  line  and  totally  on  that  line . 

A  command  cannot  be  split  on  succeeding  lines.  Only  columns  1  through 
80  of  each  line  can  be  used. 

GENERAL  COMMAND  SYNTAX 

The  command  identifiers  (name  of  the  command)  must  precede  any 
accompanying  parameter  or  list  of  parameters. 

COMMAND  PARAMETERS 

Parameters  for  a  command  separated  by  one  or  more  blanks.  Parameters 
may  be  given  in  any  order,  but  are  processed  from  left  to  right.  If 
conflicting  parameters  are  used,  the  right-most  parameter,  i.e.,  the 
last  one  given,  is  considered  to  be  correct  and  is  the  one  used  in  the 
processing  of  the  command. 

ELLIPSIS 

The  ellipsis  (...)  signifies  that  the  command  construct  immediately 
preceding  the  ellipsis  can  be  repeated  as  many  times  as  desired  by 
the  user. 

INTEGERS 

The  integers  required  for  parameters  must  be  positive  integers.  If  a 
value  range  is  given  for  a  particular  parameter  description,  that 
restriction  must  also  be  met. 

NAMES 

All  user  defined  names  (user-name)  must  meet  the  following  restrictions 
to  be  a  legal  URp,name. 

A  name  can  be  formed  only  from  the  following  characters : 

A,  B,  C,  ...,  Z  (letters) 

0,  1,  2,  ...,  9  (integers) 

-  (dash) 
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—  A  name  can  be  any  combination  of  thirty  characters  or  less 
where  the  first  character  is  a  letter. 

—  Blanks  cannot  be  used  in  the  name. 

—  A  user  defined  name  cannot  be  a  URL  RESERVED  WORD.  'For 
a  list  of  Reserved  words  see  APPENDIX  B  of  ISDOS  Working 
Paper  No.  68,  USER  REQUIREMENTS  LANGUAGE,  LANGUAGE  REFERENCE 
MANUAL. 

For  example, 

GROSS-PAY,  EMPLOYEE-NUMBER  and  PAYROLL-PROCESSING 

are  all  legal  names . 

PROCESS,  EMPLOYEE-#  and  123-HILL-STREET 

are  illegal  names.  "PROCESS"  cannot  be  used  as  a  user-name  because 
it  is  a  URL  Reserved  Word.  "EMPLOYEE-#"  uses  a  character  (the  "#" 
sign)  which  is  not  allowed  and  "123-HILL-STREET"  is  illegal  because 
it  starts  with  an  integer  rather  than  a  letter. 
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Format  of  Command  Descriptions 


All  the  URA  commands  in  this  paper  are  described  in  the  following  format: 

Command:  COMMAND-NAME  type:  command  type 

Purpose:  This  presents  the  function  of  the  command  in  the  URA 

system  whether  it  generates  a  report,  modifies  the  data 
base  or  gives  control  information  to  tjra  .  (  The,:URA  Users 

Manual"  and '*URA  Reports"  present  detailed  descriptions  of 
the  reports  generated  by  each  command.) 


Prototype:  This  presents  the  legal  syntax  for  the  command.  The 

Command  Language  Syntax  Notation  specifies  what  the 
special  symbols  (such  as  braces  and  brackets)  represent 
in  interpreting  the  syntax. 


Parameters:  For  each  parameter  available  for  the  command,  this  section 
provides  a  brief  description  explaining  how  the  parameter 
changes  the  action  of  the  command.  (The". URA  Users  Manual" 
and  "URA  Report^' explain  how  to  use  these  parameters  effectively.) 

There  are  basically  five  types  of  parameters: 


Input  data  parameters  -  these  parameters  specify 
the  data  to  be  used  as  input  to  the  command. 

FILE  and  NAME  are  examples  of  Input  data  parameters . 

• 

Input  control  parameters  -  these  parameters  specify  how 
the  input  data  is  to  be  used,  changed,  etc.,  by 
the  command.  The  TYPE  parameter  for  the  CHANGE- 
TYPE  command  and  CONTAINED/CONSISTS  parameter  for 
the  CONSISTS-MATRIX  command  are  examples  of  this 
type. 

Output  data  parameters  -  these  parameters  specify  if 
output  is  to  be  generated  from  the  command  and 
the  form  in  which  it  is  presented.  The  PUNCH  and 
PRINT  parameters  are  examples  of  this  type  of 
parameter. 

Output  option  parameters  -  these  parameters  specify 
options  which  may  be  included  or  omitted  from 
the  output.  The  LEVELS  parameter  for  the  CONTENTS 
command  and  the  DESCRIPTION  parameter  for  the 
DICTIONARY  command  are  examples  of  this  type . 

Output  format  parameters  -  these  parameters  specify 

alternate  formats  for  presenting  the  information 
in  the  output  from  the  command.  The  NEV7-PAGE 
parameter  and  HMARG  parameter  for  the  FPS 
command  are  examples  of  this . 


i 
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Defaults : 


Messages : 


Examples : 


The  parameters  for  each  command  will  be  presented 
in  the  above  order  according  to  type. 

y* 

These  present  which  parameters  will  be  used  for  /the 
command,  or  what  value  a  parameter  will  have,  if  the 
parameter,  or  value,  is  not  explicitly  defined.  For 
example,  if 

CONTENTS 

is  specified,  the  defaults  for  this  command  are  such 
that  this  has  the  same  effect  as  specifying: 

CONTENTS  FILE  NOINDEX  LEVELS = ALL  NONCFLAG 

If  a  "no  default"  is  given,  this  means  that  if  not 
explicitly  defined,  the  corresponding  parameter  will 
not  be  used  for  the  command. 

These  are  the  possible  error  messages  that  may  occur 
if  the  parameters  for  the  command  are  not  specified 
correctly.  The URA  Users  Manual'  explains  what 
to  do  should  these  messages  be  encountered. 

Actual  example  of  the  command  syntax  are  presented. 
(The  results  from  these  examples  are  presented  in 
the' URA  Users  Manual"  and  ' URA  Reports." 
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Command: 

« 

CHANGE-TYPE  T^pe:  modifier  command 

Purpose: 

To  change  the  name  type  of  a  user  name  defined  in-  the 
user's  data  "base.  A  record  of  this  change  is  generated 
in  the  form  of  the  CHANGE-TYPE  REPORT. 

Prototype : 

rHAwn?  'pyp'F  (  ot  )  j NAME ( N )  =us  er-name  TYPE(T)=name-type  j 

CHANGE- TYPE  CT  |fiLE(F) [=fdname]  [TYPE(T)=name-type] j 

Parameters : 

Input- 

data 

FILE ( F ) [ = fdname ]  De fault :  no  de  fault 

When  the  FILE  parameter  is  used  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 
If  an  fdname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  command.  The  file  format  for  each  line  of  the 
input  file  must  be  of  the  form: 

user-name  [name-type] 

Free  format  is  allowed  so  the  user-name  does  not  have  to 
start  in  the  first  position  in  the  line.  The  two  names 
must  be  separated  by  one  or  more  blanks.  The  name-type 
is  optional.  If  a  name-type  is  not  specified  for  each 
user-name,  the  name  type  for  each  of  these  names  will  be 
changed  to  the  type  specified  in  the  TYPE  parameter.  One 
of  these  alternative  methods  of  assigning  a  type  must  be 
used,  but  not  both.  If  both  are  used,  all  the  names  in 
the  file  will  be  assigned  the  name  type  specified  by  the 

TYPE  parameter. 

NAME( N ) -user-name  Default:  no  default 

The  given  user-name  is  the  name  for  which  the  change  is  to 
be  made.  When  the  NAME  parameter  is  used,  the  TYPE 
parameter  must  be  used  in  conjunction  with  it. 

Input- 

Control 

TYPE(T)=name-type  Default:  no  default 

This  parameter  specifies  the  new  name  type  to  be  used  in 
the  change.  See  Appendix  E  of  The  User  Requirements 
Language,  Language  Reference  Manual**  for  a  list  of  all 
possible  name  types. 

Messages : 

If  neither  FILE  nor  NAME  parameter  are  given,  the  error 
message: 

NO  NAME  GIVEN 

*  The  name  of  the  default  file  is  installation  dependent  and  consequently 
is  given  in  Appendix  E 

**  ISDOS  Working  Paper  No.  68 
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Examples: 


will  be  generated  by  URA.  If  one  of  these  two  parameters 
are  given,  but  no  TYPE  is  specified,  the  error  message: 


NO  TYPE  GIVEN  WITH  "NAME="  OR  "FILE"  PARAMETER./ 

k 


will  be  given. 


CHANGE-TYPE  NAME=GROSS-PAY  TYPE=ELEMENT 
CT  F  T=ELEMENT 
CT  FILE  T=GROUP 
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Command:  CONS  I  STS- COMPARISON 


!fype :  report  command 


Purpose: 

To  produce  the  CONSISTS-COMPARISON  REPORT.  ./' 

Prototype : 

CONSISTS-COMPARISON ( CNC )  [parameter] . . . 

t 

Parameters : 

t 

Input- 

Data 

FILE(F) [=fdname]  Default:  FILE 

When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are  used 
as  input  to  the  command.  This  file  is  the  default 

PUNCH  file  for  NAME-GEN.  If  an  fdname  is  indicated, 
that  file  is  used  as  the  input  file  for  the  command  and 
the  report  is  produced  using  all  the  names  in  the  file. 

In  any  case,  the  names  in  the  input  file  must  be  SET, 

INPUT,  OUTPUT,  ENTITY  and/or  GROUP  names.  The  format 
of  the  input  file  must  be  one  name  per  line. 

Examples : 

CNC 

CNC  FILE 

*  The  name  of  the  default  file  is  installation  dependent  and  consequently 
is  given  in  Appendix  E 
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Command:  CONSISTS'MATRIX 


Type :  report  command 


Purpose:  To  produce  the  CONSISTS  MATRIX  REPORT.  f 

Prototype:  CONSISTS-MATRIX(CM)  |tonSIST3(CSTS)  ' >(  tetrameter)... 


Parameters : 

Input-  FILE(F) [=fdname ] ,  NAME( N ) =user-name  Default:  FILE 
Data 

When  the  FILE  parameter  is  used  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN . 

If  an  fdname  is  indicated,  that  file  is  used  as  the  input  file 
for  the  command.  When  a  name  is  specified  via  the  NAME 
parameter,  the  report  is  produced  only  for  that  name.  The 
format  of  the  input  file  must  be  one  name  per  line . 


Input- 

Control 


CONTAINED (CNTD),  CONSISTS ( CSTS )  Default:  no  default 

Since  no  default  exists,  one  of  the  above  must  be  specified. 
If  CONTAINED  is  given,  the  names  used  as  input  must  be 
ELEMENT,  GROUP,  ENTITY,  INPUT  and/or  OUTPUT* names .  If  the 
CONSISTS  parameter  is  given  the  names  used  as  input  must  be 
SET,  ENTITY,  INPUT,  OUTPUT  and/or  GROUP  names. 


Messages:  If  neither  CONTAINED  nor  CONSISTS  is  specified,  the  message: 

MUST  GIVE  EITHER  CONSISTS  OR  CONTAINED  PARAMETER 
will  be  printed. 


Examples: 

CM 

N=EMPLOYEE-NUMBER  CNTD 

CM 

FILE  CSTS 

CM 

CSTS 

*  The  name  of  the  default  fiie  is  installation  dependent  and  consequently 
is  given  in  Appendix  E 
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Command:  CONTENTS 


Type :  report  command 


Purpose:  To  produce  the  CONTENTS  REPORT. 

Prototype:  CONTENTS ( CONT)  [parameter]... 


Parameters : 

Input-  FILE(F) [=fdname] ,.NAME(N)=user-name  Default:  FILE 
Data 

When  the  FILE  parameter  is  used  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 
If  an  fdname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  command  and  the  report  is  produced  for  all  the 
names  in  the  file.  When  a  name  is  specified  by  the  NAME 
parameter,  the  report  is  produced  for  that  name  alone.  In 
any  case,  the  names  used  as  input  to  the  command  must  be 
SET,  INPUT,  OUTPUT,  ENTITY  and/or  GROUP  names.  Hie  format 
of  the  input  file  must  be  one  name  per  line. 

Output-  INDEX,  NOINDEX  Default:  NOINDEX 

Data 

The  INDEX  parameter  specifies  the  production  of  an  index 
for  the  report  consisting  of  an  alphabetical  listing  of 
all  names  used  in  the  report  and  the  pages  on  which  they 
occur. 


Output- 

Option 


LEVELS = 


(integer 
ALL 


Default :  LEVELS = ALL 


The  LEVELS  parameter  specifies  the  lowest  level  of  subordinate 
names  to  be  outputted.  The  ALL  value  indicates  that  all 
subordinate  names  should  be  outputted.  LEVELS  can  take 
on  any  integer  value  from  1  to  50. 


NCFLAG,  NONCFLAG 


Default :  NONCFLAG 


The  NCFLAG  parameter  flags  all  GROUPS 
that  do  not  CONSIST  of  anything  else, 
names  which  are  contained  in  a  GROUP, 
or  SET. 


in  the  output  reports 
and  those  undefined 
INPUT,  OUTPUT,  ENTITY 


Examples :  CONTENTS  N*VARYING-EMPLOYEE-DATA 

CONT  F 


*  Tne  name  of  the  default  file  is  installation  dependent  and  consequently 
is  given  in  Appendix  E 
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Command: 


DATA-PROCESS 


Type :  report  command 


Purpose:  To  produce  the  DATA  PROCESS  REPORT. 


Prototype :  nATA-PROCESS ( DP ) 

Parameters : 


idata(d) 

PROCESS(P) 


[parameter] . . . 


Input-  FILE(F) [=fdname] ,  NAME(N)=user-name  Default:  FILE 
Data 


When  the  FILE  parameter  is  used  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  This  is  the  default  PUNCH  file  for  NAME-GEN.  If 
an  fdname  is  indicated,  that  file  is  used  as  the  input  file 
for  the  command.  The  format  of  the  input  file  must  be  one 
name  per  line. 


When  a  name  is  given  via  the  NAME  parameter,  the  report  is 
produced  only  for  that  name . 


Input- 

Control 


DATA(D),  PROCESS (P)  Default:  no  default 

Since  no  default  exists,  one  of  the  above  must  be  specified. 
If  DATA  is  specified,  the  names  used  as  input  to  the  command 
must  be  SET," INPUT,  OUTPUT,  ENTITY,  GROUP  and/or  ELEMENT 
names.  If  FROCESS  is  specified,  the  names  used  as  input 
to  the  command  must  be  PROCESS  names . 


DPMAT,  NODPMAT  Default:  DPMAT 

With  the  DPMAT  parameter  in  effect,  the  DATA  PROCESS 
INTERACTION  MATRIX  is  presented  as  part  of  the  report. 

When  NODPMAT  is  specified,  this  matrix  is  not  printed. 

DPANL,  NODPANL  Default:  DPANL 

With  the  DPANL  parameter  in  effect,  analysis  is  done 
on  the  DATA  PROCESS  INTERACTION  MATRIX  (whether  printed 
.  or  not)  and  presented  as  the  DATA  PROCESS  INTERACTION 
ANALYSIS.  When  NODPANL  is  specified,  this  analysis 
is  not  done. 

PMAT,  NOPMAT  Default:  PMAT 

With  the  PMAT  parameter  in  effect,  the  PROCESS  INTERACTION 
MATRIX  is  presented  as  part  of  the  report.  When  NOPMAT 
is  specified,  this  matrix  is  not  printed. 

PANL,  NOPANL  Default:  PANL 

With  the  PANL  parameter  in  effect,  analysis  is  done  on  the 
PROCESS  INTERACTION  MATRIX  (whether  printed  or  not)  and 
presented  as  the  PROCESS  INTERACTION  MATRIX  ANALYSIS. 

_  When  NOPANL  is  specified,  this  analysis  is  not  done. 

*  The  name  of  the  default  file  is  installation  dependent  and  consequently 
is  given  in  Appendix  E 


Output- 

Options 
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Messages : 


If  neither  DATA  nor  PROCESS  is  specified,  an  error 
Message: 

•  MUST  GIVE  EITHER  "DATA"  OR  "PROCESS"  PARAMETER 
will  be  printed. 


Examples:  DP  N=PAYROLL-PROCESSING  PROCESS 


DP  DATA 


Command:  DELETE 


^Vpe:  modifier  command 


Purpose:  To  delete  a  name  or  list  of  names  from  the  data  base.  When 

a  name  is  deleted  all  of  its  connections  to  other  names  in 
the  data  base  are  also  deleted.  A  permanent  record  of  the 
change  is  also  generated  in  the  form  of  the  DELETION  REPORT. 

Prototype :  DELETE(DEL) 

Parameters : 

Input  FILE(F) [=fdname] ,  NAME(N)=user-name  Default:  no  default 
Data 

When  the  FILE  parameter  is  used  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 
If  an  fdname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  command  and  all  names  in  the  file  are  deleted 
from  the  data  base .  The  format  of  the  input  must  be  one 
name  per  line.  When  a  name  is  specified  by  the  NAME 
parameter,  that  name  is  deleted  from  the  data  base. 


Messages:  If  neither  the  FILE  nor  NAME  parameter  is  specified,  the 

message : 

NO  NAME  OR  FILE  WAS  SPECIFIED 
will  be  given. 

Examples :  DELETE  N=FIELD-CHECK-NEW 

DEL  FILE 


*  The  name  of  the  default  file  is  installation  dependent  and  consequently 
is  given  in  Appendix  E 


307 


Command : 


DELETE- COMMENT- ENTRY 


type:  modifier  command 


jrpose:  To  delte  from  the  data  base,  for  the  given  name  or  list 

of  names,  those  comment  entries  associated  with  each  f 

comment  entry  statement  specified  in  the  list  of  paramfeters. 
A  permanent  record  of  the  change  is  generated  in  the  form 
of  the  DELETED  COMMENT  ENTRIES  report. 


Prototype : 


DELETE-COMMENT-ENTRY ( DCOM)  ( Jf  / 1 ! f=fdnam® ^ 

I  NAME ( N ) =us e r-name 


[parameter] . . 


Parameters : 

Input-  FILE ( F ) [ =f dname ] ,  NAME( N ) =user-name  Default:  no  default 
Data 

When  the  FILE  parameter  is  used  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  an  fdname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  command.  When  a  name  is  given  via  the  NAME 
parameter,  only  the  specified  comment  entries  for  that  name 
are  deleted.  Either  FILE  or  NAME  must  be  given  but  not 
both.  The  format  of  the  input  file  must  be  one  name  per  line. 

Input-  When  given  as  parameters ,  the  comment  entries  for  the 
Control  following  comment  entry  statements  are  deleted. 


DERIVATION (DER),  NODERIVATION (NDER)  Default: 

DESCRIPTION DESC),  NODESCRIPTION (NDESC) 
FALSE-WHILE(FW),  NOFALSE-WHILE (NFW) 

PROCEDURE (PRCD),  NOPROCEDURE (NPRCD) 

TRUE-WHILE(TW),  NOTRUE-WHILE (NTW) 

VOLATILITY (VOL),  NOVOLATILITY (NVOL) 

VOLATILITY-MEMBER( VOLM) ,  NOVOLATILITY-MEMBER (NVOLM) 
VOLATILI TY-SET ( VOLS ),  NOVOLATILITY-SET(NVOLS) 


NODERIVATION 

NODESCRIPTION 

NOFALSE-WHILE 

NOPROCEDURE 

NOTRUE-WHILE 

NOVOLATILITY 

NOVOLATILITY-MEMBER 

NOVOLATILITY-SET 


Output-  PRINT,  NOPRINT(NP)  Default:  PRINT 

Data 

The  PRINT  parameter  initiates  the  production  of  a  printed 
DELETED  COMMENT  ENTRIES  report.  NOPRINT  suppresses  the 
printing. 

•  i 


Messages:  If  neither  the  FILE  nor  NAME  parameter  are  given,  the 

message : 


NO  NAME  OR  FILE  SPECIFIED 


is  printed. 


*  The  name  of  the  default  file  is  installation  dependent  and  consequently 
in  given  in  Appendix  E 


3.08 


Examples 


DELETE-COMMENT-ENTRY  N=NEW-INFO-VALIDATION  PRCD  DESC 


DCOM  FILE 


DESC 


0 
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Command: 


Purpose: 

Prototype : 

Parameters : 

Input- 

Data 


Output- 

Data 


Example : 


DELETE- PS L 


Type :  modifier  command 


To  delete  specific  URL  statements  in  the  problem  definer's 
data  base.  Those  statements  used  as  input  to  the  command 
are  deleted.  A  permanent  record  for  the  change  is  generated 
in  the  form  of  the  DELETED  URL  report. 


DELETE-PSL(DPSL)  .  [parameter] . . . 


INPUT(l) [=fdname]  Default :  INPUT=terminal 

When  INPUT  is  used  and  an  fdname  is  specified,  the  contents 
of  the  designated  fdname  are  used  as  input  to  the  command. 
This  input  must  be  in  the  same  format  allowable  by  the 
INPUT-PSL  command  (i.e.,  legal  URL  statements).  The  only 
exception  is  that  no  comment  entry  statements  are  allowed 
in  the  input  (DESCRIPTION,  for  example).  The  EOF  statement 
terminates  input.  If  no  fdname  is  specified,  its  value 
defaults  to  the  terminal  so  that  the  URL  statements  can  be 
entered  interactively. 

SOURCE(S),  NOSOURCE(HS)  Default:  SOURCE 

When  the  SOURCE  parameter  is  in  effect,  an  AS-IS  SOURCE 
LISTING  (the  DELETED  URL  output)  of  the  deleted  URL 
statements  is  produced.  When  the  NOSOURCE  parameter  is 
given,  no  AS-IS  SOURCE  LISTING  is  produced. 

XREF(X),  NOXREF(NX)  Default:  NOXREF 

The  user  may  desire  a  cross  reference  for  the  AS-IS  SOURCE 
LISTING.  This  consists  of  a  list  of  all  user-defined  names 
from  the  input  file  and  the  line  numbers  on  which  they 
occur  in  the  DELETED  URL  report .  To  accomplish  this  ,  the 
problem  definer  should  specify  XREF.  When  NOXREF  is  in 
effect,  no  cross  reference  is  produced. 


DELETE- PS L  NS 

DPSL  X 
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•Command:  DICTIONARY 


Type :  report  command 


Purpose: 


Prototype : 

Parameters : 

Input- 

Data 


Output 

Data 


Output- 

Option 


Output 

Format 


Examples : 


*  The  name 
is  given 


To  produce  the  DICTIONARY  REPORT  for  a  name  or  list  of 
names  in  the  user's  data  base. 


DICTIONARY (DICT)  [parameter] . . . 


FILE(F) [=fdname] ,  NAME(N)=user-name  Default:  FILE 

When  the  FILE  parameter  is  used  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 
If  an  fdname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  production  of  the  DICTIONARY  REPORT.  When  a 
name  is  specified  via  the  NAME  parameter,  the  report 
is  generated  for  that  name  alone .  The  format  of  the  input 
file  must  be  one  name  per  line. 

INDEX,  NOINDEX  Default:  NOINDEX 

When  given,  the  INDEX  parameter  specifies  the  production 
of  an  index  to  the  report.  This  index  consists  of  an 
alphabetical  listing  of  all  names  used  in  the  report  and 
the  page(s)  on  which  they  occur  in  the  report. 

The  following  four  parameters  specify  the  information  to 
be  included  in  the  DICTIONARY.  The  "NO"  prefix  on  a 


parameter  specifies  that  such  information  not 
for  the  name(s). 

be  included 

DESCRIPTION  DESC) , 

NODESCRIPTION ( NDESC) 

Default : 

DESCRIPTION 

KEYWORDS (KEY) ,  NOKEYWORDS ( NKEY ) 

Default: 

KEYWORDS 

RESPONSIBLE-PD(RPD) , 

N0RESP0NSI3LE-PD ( NRPD) 

Default : 

RESPOHSIBLE-PD 

SYNONYMS ( SYN ) ,  NOSYNONYMS ( NSYN ) 

Def  atilt : 

SYNONYMS 

NUM-SPACE ( NS ) =integer 

Default : 

NUM-SPACE=2 

For.  ease  in  reading,  the  number  of  lines  skipped  between 
dictionary  entries  can  be  modified  by  varying  this 
parameter.  NUM-SPACE  may  take  on  any  value  between  0  and  10. 

DICTIONARY  N=PAYROLL-PROCESSING 
DICT  FILE 


of  the  default  file  is  installation  dependent  and  consequently 

in  Appendix  E 
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Command: 

ENTITY- IDENTIFIER  Type:  report,  command 

Purpose : 

1 

:/■ 

To  produce  the  IDENTIFIER  INFORMATION  REPORT.  / 

Prototype : 

ENTITY-IDENTIFIER  ( El)  [parameter]... 

Parameters : 

Input- 

Data 

FILE(F) [=fdname] ,  NAME ( N ) =us er-name  Default:  FILE 

When  the  FILE  parameter  is  used  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 
If  an  fdname  is  indicated,  that  file  is  used  as  in  the  input 
file  for  the  command.  If  a  name  is  specified  via  the  NAME 
parameter,  the  report  is  generated  for  that  name  alone.  The 
format  of  the  input  file  must  he  one  name  per  line. 

Input- 

Control 

IDENTIFIER(I),  ENTITY(E)  Default:  no  default 

Since  no  default  is  allowed,  one  of  the  above  must  be 
specified.  If  IDENTIFIER  is  specified,  the  names  used 
as  input  to  the  command  must  be  names  used  as  IDENTIFIERS 
in  the  data  base.  If  the  ENTITY  parameter  is  given,  the 
names  used  as  input  must  be  defined  ENTITY  names. 

Messages : 

If  neither  the  IDENTIFIER  nor  ENTITY  parameter  is  specified, 
the  message: 

MUST  GIVE  EITHER  ENTITY  OR  IDENTIFIER  PARAMETER 

will  be  given. 

Examples : 

> 

El  N=EMPLOYEE-NUMBER  I 

El  FILE  ENTITY 

*  The  name  of  the  default  file  is  installation  dependent  and  consequently 
is  given  in  Appendix  E 
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Command:  EXTENDED-PICTURE 


Type:  report  command 


Purpose:  To  produce  the  EXTENDED  PICTURE  report 


Prototype:  EXTENDED-PICTURE (EP)  [parameter]... 

Parameters: 

Input-  FILE(F)  [-fdname] ,  NAME(N)=user-name  Default:  FILE 
Data 


When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are  used 
as  input  to  the  command.  This  file  is  the  default 
PUNCH  file  for  NAME-GEN.  If  an  fdname  is  given,  that 
file  is  used  as  the  input  file  for  the  command.  The 
format  for  the  input  file  must  be  one  name  per  line. 
When  a  name  is  given  via  the  NAME  parameter,  the  report 
is  produced  only  for  that  name.  Regardless  of  whether 
FILE  or  NAME  is  specified,  all  names  used  as  input  to 
this  command  must  be  PROCESS,  INTERFACE,  INPUT,  ELEMENT , 
GROUP,  OUTPUT,  ENTITY,  or  SET  names. 


Output-  INDEX,  NOINDEX 


Default:  NOINDEX 


Data 


The  INDEX  parameter  specifies  the  production  of  an  index 
for  the  EXTENDED  PICTURE  report.  This  index  consists  of 
all  user-defined  names  used  in  the  report,  in  alphabetical 
order,  along  with  the  pages  on  which  they  appear  in  the 
report. 


Output-  STRUCTURE (S TR) ,  DATA-FLOW (DF) 
Option 


Default:  no  default 


When  the  STRUCTURE  parameter  is  used,  information  is 
obtained  for  each  input  name  from  UTILIZES,  SUBPARTS, 
CONSISTS,  and  SUBSETS  statements,  or  their  complementary 
statements.  This  information  is  then  presented  in 
graphical  format.  When  the  DATA-FLOW  parameter  is  used, 
the  graphical  output  shows  information  obtained  for  each 
input  name  from  USED,  USED  TO  DERIVE ,  USED  TO  UPDATE, 
RECEIVED,  UPDATES,  DERIVES,  and- GENERATES  statements  or 
*  their  complementary  statements.  Since  there  is  no 
default,  either  STRUCTURE  or  DATA-FLOW  must  be  specified. 

FORWARD (FWD) ,  BACKWARD (BWD)  Default:  no  default 

DOWNWARD (DOWN) ,  UPWARD (UP) 

It  is  frequently  convenient  to  think  of  FORWARD  and 
BACKWARD  as  referring  to  DATA-FLOW  and  UPWARD  and 
DOWNWARD  as  referring  to  STRUCTURE.  However,  FORWARD 
and  DOWNWARD  may  be  used  interchangeably,  as  may 


*  The  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E 
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BACKWARD  and  UPWARD.  The  FORWARD  (or  DOWNWARD)  < 
parameter  causes  retrieval  of  information  about  each 
input  name  based  on  UTILIZES,  SUBPARTS,  CONSISTS  and 
SUBSETS  statements  (for  STRUCTURE)  or  USED,  USED  TO 
DERIVE,  USED  TO  UPDATE,  RECEIVED,  UPDATES,  DERIVES, 
and  GENERATES  statements  (for  DATA-FLOW) .  The 
BACKWARD  (or  UPWARD)  parameter  causes  retrieval  of 
information  about  each  input  name  based  on  UTILIZED, 

•  PART,  CONTAINED,  and  SUBSET  statements  (for  STRUCTURE) 
or  USES,  USES  TO  DERIVE,  USES  TO  UPDATE,  RECEIVES, 

UPDATED,  DERIVED,  and  GENERATED  statements  (for  DATA¬ 
FLOW).  Since  there  is  no  default,  one  of  the  above 
parameters  must  be  specified. 

LINKS=integer  Default:  LINKS=1000 

The  LINKS  parameter  specifies  the  maximum  number  of 
links  (connections  between  names)  to  be  followed  in 
producing  the  report.  LINKS  can  take  on  any  integer 
value  between  1  and  1000,  inclusive. 

Output-  COLUMNS (COLS )=integer  Default:  C0LUMNS=119 

Format 

The  COLUMNS  parameter  specifies  the  number  of  columns  to 
be  used  for  output.  The  maximum  value  allowed  is  119. 

ROWS=integer  Default:  R0WS=39 

The  ROWS  parameter  specifies  the  number  of  rows  to  be 
used  for  output.  The  maximum  value  allowed  is  39. 

HORIZONTAL-BOXES (HB)=integer  Default:  (see  text) 

HORIZONTAL-BOXES  specifies  the  maximum  number  of  boxes 
containing  names  to  be  arranged  across  the  page.  The 
default  value  is  the  largest  possible  value  for  the 
given  value  of  COLUMNS,  and  is  computed  as  the  greatest 
integer  in  (COLUMNS-4)/17. 

.  *  VERTICAL-BOXES (VB)=integer  Default:  (see  text) 

VERTICAL- BOXES  specifies  the  maximum  number  of  boxes 

containing  names  to  be  arranged  down  the  page.  The 
default  value  is  the  largest  possible  value  for  the 
given  value  of  ROWS,  and  is  computed  as  the  greatest 
integer  in  (R0WS-2)/6. 


3U 


Messages : 


Examples: 


I 


<  ./• 

If  the  HORIZONTAL-BOXES  value  used  will  not  fit, in  the 

number  of  COLUMNS  specified,  the  message: 
HORIZONTAL-BOXES  TOO  LARGE  FOR  NUMBER  OF  COLUMNS  ON  PAGE 
will  be  given. 

If  the  VERTICAL-BOXES  value  used  will  not  fit  in  the 
number  of  ROWS  specified,  the  message: 

VERTICAL-BOXES  TOO  LARGE  FOR  NUMBER  OF  ROWS  ON  PAGE 

will  be  given.  : 

If  neither  the  DATA-FLOW  nor  STRUCTURE  parameter  is 
specified,  the  message: 

NEITHER  DATA-FLOW  NOR  STRUCTURE  WAS  SPECIFIED 
will  be  printed. 

If  none  of  FORWARD,  BACKWARD ,  UPWARD  and  DOWNWARD  is 
specified,  one  of  the  following  messages  will  be  printed 

NEITHER  FORWARD  NOR  BACKWARD  WAS  SPECIFIED 
NEITHER  UPWARD  NOR  DOWNWARD  WAS  SPECIFIED. 

EXTENDED-PICTURE  STR  DOWN  N=PROCESSl 
EP  FILE  DF  BACKWARD  LINKS=5 
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Command : 


FORMATTED-PROBLEM-STATEMENT 


Type :  report  command 


Purpose : 


Prototype : 

Parameters : 

Input- 

Data 


Output- 

Data 


Output- 

Option 


*  The  name 
is  given 


To  produce  the  FORMATTED  PROBLEM  STATEMENT  for  a  given  name, 
or  list  of  names  and/or  to  produce  this  information  in  the 
form  of  PUNCH  data. 


FORMATTED- PROBLEM-STATEMENT( FPS )  [ parameter ] . . . 


FILE(F) [=fdname] ,  NAME(N)=user-name  Default:  FILE 

When  the  FILE  parameter  is  used  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  Tnis  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  an  fdname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  command.  When  a  name  is  given  via  the  NAME 
parameter ,  the  report  is  produced  only  for  the  name 
specified.  The  format  of  the  input  file  must  be  one  name 
per  line. 

INDEX,  NOINDEX  Default:  NOINDEX 

The  INDEX  parameter  specifies  the  production  of  an  index 
for  the  FPS.  This  index  consists  of  an  alphabetical  listing 
of  all  user  defined  names  used  in  the  FORMATTED  PROBLEM 
STATEMENT  and  the  page(s)  on  which  they  occur. 

PRINT,  NOPRINT(NP)  Default :  PRINT 

The  NOPRINT  parameter  specifies  that  no  printed  output  report 
will  be  produced.  The  PRINT  parameter  specifies  the  produc¬ 
tion  of  the  FORMATTED  PROBLEM  STATEMENT . 

PUNCH (P)[=fdname],  NOPUNCH  Default:  NOPUNCH 

The  PUNCH  parameter  specifies  that  PUNCH  data  should  be 
generated  and  written  into  the  designated  PUNCH  file. 

When  the  PUNCH  parameter  is  used  and  no  fdname  is  designated, 
the  data  is  written  into  the  default  PUNCH  file.*  This 
file  is  the  default  PUNCH  file  for  the  command.  If  an 
fdname  is  indicated,  that  file  is  used  as  the  PUNCH  file. 

With  the  NOPUNCH  parameter  in  effect,  no  action  is  taken 
to  generate  PUNCH  data. 

COMMENT (COM) ,  NOCOMMENT(NCOM)-  Default:  COMMENT 

The  COMMENT  option,  when  in  effect,  specifies  the  inclusion 
of  comments  for  undefined  names.  The  NOCOMMENT  option 
suppresses  these  comments. 


of  the  default  file  is  installation  dependent  and  consequently 
i n  Appendix  E 
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rasruusi  def } ,  wudefihm  ndef ) 


ueiauit :  ur,r  xnr. 


With  the  DEFINE  option  in  effect,  DEFINE  sections  are 
included  in  the  report.  The  NODEFIKE  option  specifies 
that  no  DEFINE  sections  are  included  in  the  FORMATTED 
PROBLEM  STATEMENT. 

DESG(DG),  NODESG(NDG)  Default:  DES& 

f 

The  DESG  option,  when  in  effect,  indicates  that  DESIGNATE 
sections  are  provided  for  SYNONYM  names  in  the  FORMATTED 
PROBLEM  STATEMENT .  The  NODESG  option  suppresses  the 
production  of  such  output. 

EMPTY,  NOEMPTY  Default:  (see  text) 

When  EMPTY  is  in  effect  (the  default  when  the  PUNCH 
parameter  is  also  used)  the  PUNCH  file  is  emptied  before 
PUNCH  data  is  written  into  it.  When  NOEMPTY  is  in  effect 
(the  default  when  PUNCH  is  not  used)  no  action  is  taken 
to  empty  the  PUNCH  file. 

Output-  AMARG(AM)=integer  Default:  AMARG=10 

format 

The  AMARG  parameter  indicates  the  column  at  which  the  first 
name  of  a  name  pair  is  to  be  outputted.  An  example  of  a 
name  pair  can  be  found  in  the  ATTRIBUTE  statement  where  the 
syntax  requires  an  ATTRIBUTE  name  and  ATTRIBUTE-VALUE.  AMARG 
must  take  on  some  value  greater  than  SMARG  and  less  than  BMARG. 

BMARG(BM)=integer  Default:  BMARG=25 

The  BMARG  parameter  indicates  the  column  at  which  the 

second  name  of  a  pair  is  to  be  outputted.  BMARG  must  take  on  some 

value  greater  than  AMARG  and  less  than  RNMARG-30. 

CMARG(CM)=integer  Default:  CMARG=1 

The  CMARG  parameter  specifies  the  number  of  columns  from 
SMARG  the  text  (comment  entry)  for  a  comment  entry  statement 
begins.  CMARG  must  take  on  some  value  greater  than  0  and  less 
than  RMARG-72.* 

HMARG(HM)  =integer  Default :  HMARG=l40 

This  parameter  specifies  the  column  where  the  user  defined 
name  in  a  section  header  statement  are  to  be  printed  on  the 
output.  HMARG  must  take  on  some  value  greater  than  SMARG  and  less 
than  RMARG-30. * 

NEW-LINES(NL) ,  NONEW-LINE(NNL)  Default:  NONEW-LINE 

When  the  NEW-LINE  parameter  is  given,  the  first  name  of 
a  name  list  associated  vith  a  statement  will  appear  on 
the  line  succeeding  the  statement  identifier  (name  of  the 
statement).  The  NONEW-LINE  parameter  initiates  the  list 
on  the  same  line  as  the  statement  identifier. 


*  RMAKG  has  the  value  119  at  most  installations. 
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Examples : 


NEW-PAGE(NPG),  NONEW-PAGE (NNPG)  Default:  NONEW-PAGE 

I 

When  given,  the  NEW-PAGE  parameter  specifies  that  each 
section  of  the  FPS  be  printed  on  a  separate  page.  •  NONEW- 
PAGE  signifies  that  the  sections  will  follow  one-  another 
on  a  page  within  the  page  size  restrictions.  In  any  case, 
interrupted  sections  will  be  continued  on  succeeding  pages. 

NMARG(NM)=integer  Default:  NMARG=20 

Hie  NMARG  parameter  indicates  the  column  in  which  the 
name  or  first  name  of  a  name  list  for  any  statement  will 
be  outputted.  NMARG  must  take  on  some  value  greater  than 
SMARG  and  less  than  RNMARG-30. 

ONE-PER-LINE(OPL),  SEVERAL- PER-LI KE ( S PL ) 

Default:  ONE-PER-LINE 

The  ONE-PER-LINE  option  indicates  that  the  names  in  a 
name  list  for  any  statement  will  appear  on  succeeding  lines. 
SEVERAL-PER-LINZ  option  signifies  that  names  in  a  name 
list  will  appear  on  the  same  line. 

RNMARG(RM)=integer  Default:  RNMARG=70 

Specifies  the  right-hand  margin  for  names  in  a  name  list 
when  the  SEVEPAL-PER-LINE  parameter  is  in  effect.  RNMARG  must 
take  on  some  value  greater  than  MAX(BMARG,  NMARG) +29  and  less 
than  RMARG-30. * 

SMARG(SM)=integer  Default:  SMARG=5 

The  SMARG  parameter  indicates  the  column  in  which  the 
statement  identifier  (name  of  the  statement)  will  be  started. 
SMARG  must  take  on  some  value  greater  than  0  and  less  than 
MIN (AMARG ,  NMARG). 

FPS  N= FI ELD-CHECK- NEW 

FPS  FILE 


*  RMARG  has  the  value  119  at  most  installations. 


Type:  report  command 


Command: 

FREQUENCY 

Purpose: 

To  produce  the  FREQUENCY  REPORT. 

Prototype: 

FREQUENCY (FREQ) 

Parameters : 

None 

Examples : 

FREQ 
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Command: 


HELP 


Purpose: 


Prototype : 

Paramete  rs : 


Examples : 


To  provide  the  on-line  user  with  a  list  of  possible  commands 
for  URA  or  information  about  the  parameters  for^a  particular 
URA  command. 


HELP  [parameter] ... 


Command-name  Default:  (see  text) 

If  no  command-name  is  given,  a  list  of  currently  available 
URA  commands  is  given.  If  a  command-name  is  given,  then 
the  parameters  for  that  command  are  presented.  Abbreviations 
1  for  the  command-name  are  also  acceptable . 

SHORT,  LONG  Default:  SHORT 

If  SHORT  is  given,  only  the  parameters  for  the  given  command 
are  printed.  If  LONG  is  given,  explanations  of  the  various 
parameters  are  also  printed. 


HELP  FPS  LONG 
HELP  CONTENTS 
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Command: 


INPUT-PSL 


Type:  modifier  command 


Purpose: 

Prototype : 

Parameters : 

Input- 

Data 


Input- 

Control 


Output - 
Data 


Examples : 


To  add  information  to  the  URA  data  base  to  expand' or  modify 
the  problem  statement.  A  permanent  record  of  the  change 
can  be  generated  in  the  form  of  the  AS-IS  SOURCE  LISTING 
and  URA  CROSS  REFERENCE. 


INPUT-PSL( IP)  [parameter ] . . . 


INPUT(l)=fdname  Default:  INPUT=terminal 

When  INPUT  is  specified,  the  contents  of  the  designated 
fdname  are  used  as  input  to  the  command.  This  input  must 
be  in  the  format  of  legal  URL  statements  as  specified  by 
ISDOS  Working  Paper  No.  68.  The  EOF  statement  terminates 
input.  If  the  INPUT  parameter  is  not  specified,  input  is 
read  from  the  terminal  so  that  the  URL  statements  can  be 
entered  interactively. 

DBREF(D),  NODBREF(ND)  Default:  DBREF 

The  DBREF  parameter  allows  the  referencing  of  the  data  base 
by  URA  in  its  syntax  and  semantic  analysis.  When  given, 
NODBREF  allows  the  analyzer  to  only  perform  a  syntax  check 
of  the  input. 

UPDATE(U),  NOUPDATE (NU)  Default:  NOUPDATE 

With  the  UPDATE  parameter  given,  the  input  will  update  the 
URA  data  base.  NOUPDATE  indicates  that  the  data  base  is 
not  to  be  changed. 

SOURCE(S),  NOSOURCE (NS )  Default:  SOURCE 

When  the  SOURCE  parameter  is  in  effect,  AS-IS  SOURCE  LISTING 
of  the  input  URL  is  produced.  When  the  NOSOURCE  parameter 
is  given,  the  listing  is  not  produced. 

XREF(X),  NOXREF(NX)  Default:  NOXREF 

XREF  specifies  that  a  URA  CROSS  REFERENCE  is  to  be 
generated  for  the  AS-IS  SOURCE  LISTING.  This  consists 
of  a  list  of  all  user  defined  names  from  the  input  file 
and  the  line  numbers  on  which  they  occur  in  the  AS-IS 
SOURCE  LISTING. 


INPUT-PSL  XREF  UPDATE 

IP  U 
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Command: 


KWIC 


Default: 


report  command 


Purpose:  To  produce  a  KWIC  INDEX  for  a  list  of  names.  :/ 

t 

Prototype:  KWIC  [parameter]... 

Parameters : 

Input-  FILE(F) [=fdname]  '  Default:  FILE 

Data 

When  the  FILE  parameter  is  vised  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME- GEN . 

If  an  fdname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  command.  The  format  of  the  input  file  must  be 
one  name  per  line. 

Output-  DIF=integer  Default:  DIF=20 

Format 

DIF  is  the  number  of  spaces  allowed  between  the  keyword  and 
the  rest  of  the  name  as  it  appears  in  the  output.  DIF  must  take 
on  some  value  greater  than  1  and  less  than  53.  : 


Examples :  KWIC  DIF=10 

KWIC 


*  The  name  of  the  default  file  is  installation  dependent  and  consequently 
is  given  in  Appendix  E 
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Command: 


NAME-GEN 


Default:  report  command 


Purpose:  To  produce  the  NAME-GEN  report  and/or  retrieve  certain 

names  to  be  put  in  a  PUNCH  file  and  used  as  input  to 
other  commands . 


Prototype:  NAME-GEN(NG)  [parameter] . . . 


Parameters : 

Output-  PRINT,  NOPRINT ( NP)  Default:  PRINT 

Data 

The  PRINT  parameter  intiates  the  production  of  a  printed 
output  (NAME  GEN);  NOPRINT  suppresses  printing  of  such  a 
report . 

PUNCH(P) [=fdname ] ,  NOPUNCH  Default:  PUNCH 


The  PUNCH  parameter  specifies  that  PUNCH  data  should  be 
generated  and  written  into  the  designated  PUNCH  file.  When 
the  PUNCH  parameter  is  used  and  no  fdname  is  designated, 
the  data  is  written  into  the  default  PUNCH  file.*  This  file 
is  vised  as  the  PUNCH  file.  With  the  NOPUNCH  parameter 
in  effect,  no  action  is  taken  to  generate  PUNCH  data. 


Output - 
Option 


EMPTY,  NOEMPTY  Default:  (see  text) 

When  EMPTY  is  in  effect  (the  default  when  the  PUNCH  parameter 
is  also  used)  the  PUNCH  file  is  emptied  before  the  list  of 
names  is  written  into  it.  When  NOEMPTY  is  in  effect  (the 
default  when  PUNCH  is  not  used)  no  action  is  taken  to 
empty  the  PUNCH  file. 


Hie  following  retrieval  parameters  indicate  the  types  of 
names  to  be  retrieved  and  placed  in  the  output  file .  A 
"NO"  prefix  attached  to  a  parameter  means  that  names  of 
that  type  are  not  to  be  retrieved. 


Name  Tyne 

ATTIBUTE ( ATTR ) ,  NOATTRIBUTE ( NATTR ) 
ATTRIBUTE-VALUE(ATTV) ,  NOATTRIBUTE-VALUE(NATTV) 
CONDITION( cond ,  nocohdition( ncond ) 
element(ele),  noelement (nele) 
entity(ent),  noentity (nent) 
event(ev),  noevent(nev)  , 


Default 

noattribute 

noattribute-value 

nocondition 

noelement 

noentity 

noevent 


*  The  name  of  the  default  file  is  installation  dependent  and  consequently 
is  given  in  Appendix  E 
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* 

Name  Type 

Default 

GROUP (GR),  NOGROUP (NGR) 

NOGROUP 

INPUT (IN?) ,  NOINPUT (NINP) 

NOINPUT 

INTERFACE (INTF) ,  NOINTERFACE (NINTF)* 

NOINTERFACE 

INTERVAL (INT) ,  NOINTERVAL (NINT) 

NOINTERVAL 

KEYWORD (KEY ) ,  NOKEYWORD ( NKEY ) 

NOKEYWORD 

MAILBOX (BOX) ,  NOMAILBOX (NBOX) 

NOMAILBOX 

MEMO,  NOMEMO (NMEMO) 

NOMEMO 

OUTPUT (OUT) ,  NOOUTPUT (NOUT) 

NOOUTPUT 

PROBLEM-DEFINER (PD) ,  NOPROBLEM-DEFINER (NPD) 

NOPROBLEM-DEFINER 

PROCESS (PROC) ,  NOPROCESS (NPROC) 

NOPROCESS 

REAL-WORLD- ENTITY (RWE) ,  NOREAL-WORLD-ENTITY (RWE) 

NOREAL-WORLD-ENTITY 

RELAT ION (RLN) ,  NORELATION (NRLN ) 

NORELATION 

SECURITY (SEC) ,  NOSECURITY (NSEC) 

NOSECURITY 

SET,  NOSET 

NOSET 

SOURCE(SRC),  NOSOURCE (NSRC) 

NOSOURCE 

SUBSETTING-CRITERION(SSCN) , 

NOSUBSETTING-CRITERION  ( IJSSCN ) 


NOSUBSETTING-CRI TERION 


SYSTEM-PARAMETER ( SYSP)  ,  NOSYSTEM-PARAMETER  (NSYSl)  NOSYSTEM-PARAMETER 
UNDEFINED(UNDF),  NOUNDEFINED( NUNDF)  NOUNDEFINED 


NONE,  ALL  Default:  NONE 

With  the  NONE  parameter,  all  Name  Type  switches  are  set 
to  an  "off"  position  and  names  of  no  types  (hence,  no 
names)  are  retrieved.  When  the  ALL  parameter  is  given, 
all  types  of  names  are  included  in  the  output  except 
SYNONYMS  and  UNDEFINED  names. 

TOTAL  Default:  no  default 


The  TOTAL  parameter  specifies  the  inclusion  of  all  name 
types  including  SYNONYMS  and  UNDEFINED  names  in  the  output. 

SUBLEVEL(SL)=integer  Default:  SUBLEVEL=0 

This  parameter  (to  be  used  in  conjunction  with  the  SUBPARTS- 
OF  parameter)  specifies  the  level  to  which  the  SUBPARTS 
tree  should  be  traversed  and  names  retrieved.  The  zero 
(o)  value  indicates  all  levels  should  be  retrieved. 


SUBPARTS-OF( SO ) = user- name 


Default:  no  default 


This  parameter  retrieves  all  SUBPARTS  (down  to  the  level 
specified  by  the  SUBLEVEL  parameter)  of  the  designated  user¬ 


name.  The  user-name  may  be  a  PROCESS, 


OUTPUT  or  INTERFACE. 


*  REAL-WORLD-ENTITY  may  be  used  in  place  of  INTERFACE. 
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IDENTIFIER  ID) , 

IDENTIFIER-ELEMEHT( IDE) ,  IDENTIFIER-GROUP( IDG) 

•  Default:  no  default 


IDENTIFIER  retrieves  only  those  names  which  are  used  as 
IDENTIFIERS  in  the  data  base.  IDENTIFIER-ELEMENT  retrieves 
only  those  that  are  defined  as  ELEMENT  names  and  are  used 
as  IDENTIFIERS,  and  IDENTIFIER-GROUP  retrieves  only  those 
defined  as  GROUP  names  and  are  used  as  IDENTIFIERS. 

Specific  names  can  be  selected  from  those  names  retrieved 
by  the  retrieval  parameters  when  using  the  following 
selection  parameters : 

BASIC,  NOBASIC  Default:  BASIC 

The  BASIC  parameter  specifies  that  basic  names  be  included 
in  the  output  list  of  the  requested  name  types .  "Basic" 
names  are  those  names  which  are  not  SYNONYMS. 

SYNONYM (SYN),  NOSYNONYM (NSYN)  Default:  NOSYNONYM 

The  SYNONYM  parameter  specifies  that  in  addition  to  the 
basic  names  retrieved,  the  synonyms  for  these  basic  names 
should  be  included  in  the  output  list  of  requested  name 
types.  If  only  synonyms  are  desired  then  NOBASIC  should 
also  be  specified  when  using  the  SYNONYM  parameter. 

KEY=us er-name  Default :  no  default 

Only  those  names  with  the  given  user-name  as  a  KEYWORD 
are  selected  to  be  part  of  the  output.  The  user-name 
must  be  a  name  defined  as  a  KEYWORD  in  the  data  base . 


PD= us er-name 


Default :  no  default 


Output- 

Format 


Only  those  names  associated  with  the  specified  PROBLEM- 
DEFIHER  are  selected  to  be  part  of  the  output.  The  user- 
name  must  be  a  PROBLEM-DEFINER  name  defined  in  the  data 

base. 


ORDER= 


(ALPHA  I 
j BYTYPE j 


Default :  ORDER=ALPHA 


With  ORDER  equal  to  ALPHA,  the  report  presents  the 
retrieved  names  in  alphabetical  order  by  name.  BYTYPE 
signifies  that  the  names  are  grouped  by  name  type  with 
the  types  alphabetically  ordered  and  names  within  the  same 
type  ordered  alphabetically  by  name. 


Examples : 

NG 

PROCESS  RWE 

NG 

ALL 

NG 

ALL  KEY=L1 

NG 

SO=TIME-CARD  PD=WALTER-J-RATAJ  KEY=L1 
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Command: 


NAME-LIST 


Default: 


report  command 


Purpose:  To  produce  the  NAME  LIST  report.  jf 

Prototype:  NAME-LIST(NL)  [parameter]...  * 

Parameters : 

Output-  ORDER= 

Format 

If  ORDER-ALPHA  is  specified,  the  list  is  ordered  by 
the  URAname  of  the  object,  if  ORDER=BYTYPE  is  specified, 
the  order  is  alphabetical  by  name  type,  with  objects  of 
the  same  type  being  ordered  by  name. 


ALPHA  [ 
[ BYTYPE [ 


Default :  ORDER=ALPHA 


Examples :  NAME-LIST 

NL  ORDER=BYTYPE 
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Command :  PICTURE 

* 


Type :  report  command 


Purpose:  To  produce  the  PICTURE  report. 


Prototype :  PICTURE(PIC)  [parameter] . . . 


Parameters: 

Input-  FILE(F) [=fdname]  /  NAME(N)=user-name  Default:  FILE 
Data 

When  the  FILE  parameter  is  used  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME- GEN . 
If  an  fdname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  command.  When  a  name  is  given  via  the  NAME 
parameter,  the  report  is  produced  only  for  that  name.  In 
any  case,  the  names  used  as  input  to  this  command  must  be 

INTERFACE,  PROCESS,  SET,  INPUT,  OUTPUT,  ENTITY,  GROUP 
and/or  ELEMENT  names.  The  format  of  the  input  fixe  must 
be  one  name  per  line. 

Output-  INDEX ,  NOINDEX  Default:  NOINDEX 

Data 

The  INDEX  parameter  specifies  the  production  of  an  index 
for  the  PICTURE  report.  This  index  consists  of  all  user 
defined  names  used  in  the  report,  in  alphabetical  order 
and  the  pages  on  which  they  appear  in  the  report. 

Output-  DATA(D),  NODATA(ND)  Default:  DATA 

Option 

With  the  DATA  parameter  in  effect,  information  applicable 
and  available  for  the  given  name,  or  list  of  names  other 
than  structure  or  flow  data  is  printed  on  the  output. 

NODATA  inhibits  such  action. 

FLOW,  NOFLOW  Default:  FLOW 

This  parameter  presents  flow  information  in  the  PICTURE 
report.  It  presents  RECEIVES  and  GENERATES  information 
between  INPUTS  and  OUTPUTS  with  PROCESSES  and  INTERFACES. 

It  also  presents  USES  and  DERIVES  information  between 
PROCESSES  and  data  (such  as  SETS,  ENTITIES,  GROUPS  and 
ELEMENTS). 

STRUCTURE (STR),  NOSTRUCTURE ( N3TR )  Default:  STRUCTURE 


When  the  STRUCTURE  parameter  is  in  effect,  the  information 
available  in  the  SUBPARTS,  CONSISTS  and/or  SU3SETS 
statements  and  their  complementary  statements  for  the 
input  narae(s)  appears  in  the  report. 


*  The  name  of  the  default  file  is  installation  dependent  and  consequently 
is  given  in  Appendix  E 
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Examples : 


PICTURE  N= PAY CALC-UPDATING 


PIC  N=PAYROLL-PROCESSING  NODATA  NOFLOW 
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Command: 


PRINT-ATTRIBUTE-VALUES 


Type :  report  command 


Purpose: 

To  produce  the  ATTRIBUTE  REPORT. 

Prototype : 

FRIRT-ATTRIBUTE-VALUES ( PAV )  [parameter ] . .  . 

Parameters : 

Input- 

Data 

FILE(F) [=fdname],  ,NAME(N)=user-narae  Default:  FILE 

When  the  FILE  parameter  is  used  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 
If  an  fdname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  command.  The  input  file  format  must  he  one 
ATTRIBUTE  name  per  line.  When  a  name  is  specified  hy  the 
NAME  parameter,  the  report  is  generated  for  that  name  only. 
In  any  case ,  only  ATTRIBUTE  names  may  be  used  as  input  to 
this  command. 

Examples : 

PRINT-ATTRIBUTE-VALUES  FILE 

PAV  N=TYPE 

*  Tiie  name  of  the  default  file  is  installation  dependent  and 
consequently  is  given  in  Appendix  E 
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Command: 


•PROCESS-CHAIN  Type: 

Purpose:  To  produce  the  PROCESS  CHAIN  report. 

Prototype:  PROCESS-CHAIN (PC)  [parameter]... 

Parameters: 

Input-  FILE (F) [“fdname ], NAME (N)=user-name  Default:  FILE 

Data 

When  the  FILE  parameter  is  used  and  no  fdname  is 
designated,  the  contents  of  the  default  file*  are  used 
as  input  to  the  command.  This  file  is  the  default 
PUNCH  file  for  NAME-GEN.  .  If  an  fdname  is  given,  that 
file  is  used  as  the  input  file  for  the  command.  The 
format  for  the  input  file  must  be  one  name  per  line. 

When  a  name  is  given  via  the  NAME  parameter,  the  report 
is  produced  only  for  that  name.  Regardless  of  whether 
FILE  or  NAME  is  specified,  all  names  used  as  input  to 
this  command  must  be  EVENT  or  PROCESS  names. 

INDEX,  NOINDEX  Default:  NOINDEX 

The  INDEX  parameter  specifies  the  production  of  an  index 
for  the  PROCESS  CHAIN  report.  This  index  consists  of 
all  user-defined  names  used  in  the  report,  in  alphabetical 
order,  along  with  the  pages  on  which  they  appear  in  the 
report. 

LINKS=integer  Default:  LINKS=1000 

The  LINKS  parameter  specifies  the  maximum  number  of  links 
(connections  between  names)  to  be  followed  in  producing 
the  report.  LINKS  can  take  on  any  integer  value  between 
1  and  1000,  inclusive. 


Output 

Format 


The  ROWS  parameter  specifies  the  number  of  rows  to  be  used 
for  output.  The  maximum  value  allowed  is  39. 


-  COLUMNS (COLS )=integer  Default:  C0LUMNS=119 

The  COLUMNS  parameter  specifies  the  number  of  columns 
to  be  used  for  output.  The  maximum  value  allowed  is  119. 

,R0WS=integer  Default:  ROWSre39 


Output- 

Option 


Output- 

Data 


report  command 


*  The  name  of  the  default  file  is  ins  tall  <a  cion-dependent  and 
consequently  is  given  in  Appendix  E 
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Messages: 


Examples: 


HORIZONTAL-BOXES (HB)=integer  Default:  (see  text) 

HORIZONTAL-BOXES  specifies  the  maximum  number  of  boxes 
containing  names  to  be  arranged  across  the  page.  The 
default  value  is  the  largest  possible  value  for  the 
given  value  of  COLUMNS,  and  is  computed  as  the  greatest 
integer  in  (COLUMNS-4)/17. 


VERTICAL-BOXES (VB)=integer  Default:  (see  text) 

VERTICAL-BOXES  specifies  the  maximum  number  of  boxes 
containing  names  to  be  arranged  down  the  page.  The 
default  values  is  the  largest  possible  value  for  the 
given  value  of  ROWS,  and  is  computed  as  the  greatest 
integer  in  (ROWS-2)/6. 

If  the  HORIZONTAL-BOXES  value  used  will  not  fit  in  the 
number  of  COLUMNS  specified,  the  message 

HORIZONTAL-BOXES  TOO  LARGE  FOR  NUMBER  OF  COLUMNS  ON  PAGE 

will  be  given. 

If  the  VERTICAL-BOXES  value  used  will  not  fit  in  the 
number  of  ROWS  specified,  the  message 

VERTICAL-BOXES  TOO  LARGE  FOR  NUMBER  OF  ROWS  ON  PAGE 

will  be  given. 

PROCESS-CHAIN  N=EVENTl 

PC  FILE  LINKS=4  INDEX 
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•  • 

Command:  PROCESS"  I NPUT-OUTPUT  Type:  report  command 

4 


Purpose: 

To  produce  the  PROCESS  INPUT/OUTPUT  report.  / 

Prototype : 

PROCESS-INPUT-OUTPUT(PRIO)  [parameter] . . . 

Parameters : 

Input- 

Data 

FILE(F)  =  [fdname] ,  NAME(N)=user-name  Default:  FILE 

* 

When  the  FILE  parameter  is  used  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 

If  an  fdname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  command  and  the  report  is  produced  using  all 
the  names  in  the  file.  When  a  single  name  is  specified  "by 
the  NAME  parameter,  the  report  is  produced  for  that  name 
alone.  Either  FILE  or  NAME  can  "be  used  but  not  both.  In 
any  case,  all  the  names  vised  as  input  to  this  command  must 
be  PROCESS  names.  The  input  file  format  is  one  PROCESS 
name  per  line. 

Output- 

Data 

INDEX,  NOINDEX  Default:  NOINDEX 

When  given,  the  INDEX  parameter  specifies  the  production 
of  an  index  into  the  report.  The  index  consists  of  all 
input  and  output  names  in  the  report,  in  alphabetical  order 
and  the  page(s)  on  which  they  occur  in  the  report. 

\ 

PRINT,  NOPRINT(NP)  Default:  PRINT 

Output- 

Option 

The  NOPRINT  parameter  specifies  that  no  printed  output 
report  will  be  produced.  The  PRINT  parameter  specifies 
the  production  of  the  PROCESS  INPUT/OUTPUT  report. 

DESCRIPTION DESC) ,  NODESCRIPTION(NDESC) 

Default:  DESCRIPTION 

When  the  DESCRIPTION  parameter  is  in  effect,  the  comment- 
entry  associated  with  the  DESCRIPTION  statement,  for  all 

PROCESS  used  as  input,  is  retrieved  and  printed  on  the  report. 
NODESCRIPTION  specifies  that  this  information  is  not  to  be 
retrieved. 

PROCEDURE ( PRCD ) ,  NOPROCEDURE(NPRCD)  Default:  NOPROCEDURE 

When  the  PROCEDURE  parameter  is  specified,  the  comment  . 

entry  associated  with  the  PROCEDURE  statement,  for  each 

PROCESS  name  used  as  input,  is  retrieved  and  printed  on 
the  report.  With  the  NOPROCEDUF.S  parameter  in  effect, 
this  information  is  not  retrieved. 

*  The  name  of  the  default  file  is  installation  dependent  and  consequently 
is  given  in  Appendix  E 
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INPUT(INP),  NOINPUT(NINP) 


Default:  INPUT 
r 

When  the  INPUT  parameter  is  in  effect ,  all  the  names  of 
objects  used  as  input  to  each  PROCESS  (i.e.,  names 
associated  with  the  RECEIVES  and  USES  statements)  are 
retrieved  and  printed  on  the  report .  The  NOINPUT  parameter 
specifies  that  this  information  is  not  to  be  retrieved. 

OUTPUT(OUT),  NOOUTPUT (NOUT)  Default:  OUTPUT 

When  the  OUTPUT  parameter  is  in  effect,  all  the  names  of 
objects  designated  as  output  from  each  PROCESS  (i.e.,  names 
associated  with  the  GENERATES,  DERIVES,  and  UPDATES  state¬ 
ments)  are  retrieved  and  printed  on  the  report.  The 
NOOUTPUT  parameter  specifies  that  this  information  is  not 
to  be  retrieved. 

Output-  NEW-PAGE(NPG) ,  NONEW-PAGE(NNPG)  Default:  NONEW-PAGE 

Format 

When  given,  the  NEW-PAGE  parameter  specifies  that  each  section 
of  the  PROCESS  INPUT/OUTPUT  report  be  printed  on  a  separate 
page.  NONEW-PAGE  signifies  that  the  sections  will  follow  one 
another  on  a  page  within  the  page  size  restrictions.  In  any 
case,  interrupted  sections  will  be  continued  on  succeeding  pages. 


Examples :  PRIO  N=PAYROLL-PROCESSING 

PRIO  F  NDESC  NPG  PRCD 
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Command:  PUNCH-COMMENT-ENTRY 


Type '  report  command 


Purpose:  To  produce  the  PUNCHED  COMMENT  ENTRIES  report  and?or  punch 

the  specified  comment  entries  into  a  PUNCH  file. 

Prototype :  PUNCH-COMMENT-ENTRY ( PCOM)  [ parameter ] . . . 

Parameter: 

Input-  FILE(F) [*fdname] ,  NAME(N)=user-name  Default:  FILE 
Data  ' 

When  the  FILE  parameter  is  used  and  no  fdname  is  designated, 
the  contents  of  the  default  file*  are  used  as  input  to  the 
command.  This  file  is  the  default  PUNCH  file  for  NAME-GEN. 
If  an  fdname  is  indicated,  that  file  is  used  as  the  input 
file  for  the  command.  When  a  name  is  specified  by  the  NAME 
parameter,  the  output  is  produced  for  that  name  alone.  The 
format  of  the  input  file  must  be  one  name  per  line . 

Output-  PRINT,  NOPRINT(NP)  Default:  PRINT 

Data 

The  PRINT  parameter  initiates  the  production  of  printed 
output  for  the  report.  When  the  NOPRINT  parameter  is  given, 
the  PUNCH  COMMENT  ENTRIES  report  is  not  produced. 

PUNCH (P)[=fdname],  NOPUNCH  Default:  PUNCH 


The  PUNCH  parameter  specifies  that  PUNCH  data  should  be 
generated  and  written  into  the  designated  PUNCH  file.  When 
the  PUNCH  parameter  is  used  and  no  fdname  is  designated, 
the  data  is  written  into  the  default  PUNCH  file.*  This 
file  is  the  default  PUNCH  file  for  the  command.  If  an 
fdname  is  indicated,  that  file  is  used  as  the  PUNCH  file. 

With  the  NOPUNCH  parameter  in  effect,  no  action  is  taken 
to  generate  PUNCH  data. 

Output-  EMPTY,  NO EMPTY  Default:  (see  text) 

Option 

When  EMPTY  is  in  effect  (the  default  when  the  PUNCH  parameter 
Is  also  used)  the  PUNCH  file  is  emptied  before  PUNCH  data 
Is  written  into  it.  When  NOEMPTY  is  in  effect  (the  default 
when  PUNCH  is  not  used)  no  action  is  taken  to  empty  the 
PUNCH  file. 


*  The  name  of  the  default  file  is  installation  dependent  and  consequently 
is  given  in  Appendix  E 
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Examples : 


The  comment  entries  associated  with  the  following  types 
comment ' entry  statements  are  retrieved  when  given  as 
parameters . 

DERIVATION  DER ) ,  NODERIVATION (NDER)  Default : 

DESCRIPTION ( DESC ) ,  NODESCRIPTION (NDESC) 

FALSE-WHILE ( FW ) ,  NOFALSE-WHILE (NFW) 

PROCEDURE(PRCD),  NOPROCEDURE (NPRCD) 

TRUE-WHILE ( TW) ,  NOTRUE-WHILE (NTW) 

VOLATILITY ( VOL ) ,  NOVOLATILITY (NVOL) 

VOLATILITY-MEMBER ( VOLM) ,  NOVOLATILITY-MEMBER (NVOLM) 
VOLATILI TY - SET ( VOLS ),  NOVOLATILITY-SET (NVOLS) 

PCOM  N=PAYROLL- PROCESSING  DESC 

PCOM  F  DESC  PRCD 


of 

/ _  _ 

'noderivation 

NODESCRIPTION 

NOFALSE-WHILE 

NOPROCEDURE 

NOTRUE-WHILE 

NOVOLATILITY 

NOVOLATILITY-MEMBER 

NOVOLATILITY-SET 
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Command : 


RENAME 


Type  :  modifier  command 


Purpose:  To  change  the  name  of  some  object  in  the  data  ba3e  and  to 

produce  the  RENAME  REPORT  as  a  permanent  record  of  the 
change . 

l OLD( 0 )  =us er-name  NEW(N)=user-name  ) 
Prototype:  RENAME(REN)  jIHPUI(I)=faMae  j 

Parameters : 

Input-  INPUT( I )  =f dname  Default:  no  def atilt 

Data 

For  multiple  name  changes,  an  input  file  can  be  used.  Each 
line  of  the  file  must  consist  of  the  old  name  followed 
by  the  new  name.  The  two  names  must  be  separated  by  one 
or  more  blanks . 

0LD(0)=us er-name  Default :  no  def atilt 

The  user-name  specified  here  is  the  name  that  is  to  be 
changed.  This  name  must  be  defined  in  the  data  base. 

NEW ( N ) =user-name  Default:  no  default 

The  user-name  specified  here  is  the  name  to  replace  the  old 
name.  If  the  new  name  is  already  in  the  data  base,  the 
name  will  not  be  changed. 

For  a  single  change,  both  OLD  and  NEW  must  be  given  with 
legal  values . 


Messages:  If  neither  INPUT  nor  the  OLD  and  NEW  parameters  are 

specified  the  message: 

MUST  GIVE  OLD  AND  NEW,  OR  INPUT 

will  be  given. 

Examples :  RENAME  OLD=EMPLOYEE-CODE  NEW=EMPLOYEE-NUMBER 
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Command: 


REPLACE-COMMENT-ENTRY 


Type:  modifier  command 


Purpose:  To  replace,  for  a  given  name,  specific  comment  entries 


associated  to  it.  A  REPLACED  COMMENT  ENTRIES  report  is 
also  printed  as  a  permanent  record  of  the  change . 

Prototype : 

REPLACE-COMMENT-ENTRY (RCOM)  [parameter] . . . 

Parameters : 

- 

Input- 

Data 

INPUT(l)=fdname  Default:  (see  text) 

Hie  designated  fdname  contains  the  new  comment  entries  that 
will  replace  specified  old  comment  entries  in  the  data  base. 
Hie  required  format  of  the  file  is  the  same  as  that  punched 
by  PUNCH- COMMENT-ENTRY .  If  INPUT  is  not  given,  the  input 
will  be  taken  from  the  default  file.*  This  file  is  the 
default  PUNCH  file  for  PCOM.  For  each  comment  entry  to 
be  replaced,  the  following  format  must  be  given  in  the  input 
file: 

name 

comment-entry  type i 

• 

• 

Output- 

Data 

# 

comment  entry  text 

• 

• 

t 

• 

•  » 

Where  name  is  a  name  defined  in  the  data  base ,  the  comment- 
entry-type  (e.g.,  DESCRIPTION,  VOLATILITY,  etc.)  must  be 
followed  by  a  semicolon.  The  text  following  this  must  also 
be  followed  by  a  semicolon.  This  sequence  of  lines  can  be 
repeated  as  many  times  as  necessary  in  the  input  file. 

PRINT,  NOPRINT(NP)  Default:  PRINT 

The  PRINT  parameter  initiates  the  production  of  the  REPLACED 
COMMENT  ENTRIES  report;  NOPRINT  suppresses  printing.  The 
report,  if  produced,  contains  both  the  old  and  new  comment 
entries . 

Examples : 

RCOM  NOPRINT 

*  The  name  of  the  default  file  is  installation  dependent  and  consequently 
is  given  in  Appendix  E 
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Command:  STRUCTURE 


Type :  report  command 


Purpose:  To  produce  a  STRUCTURE  report  for  INPUTS,  OUTPUTS,,  PROCESSES, 

or  INTERFACES.  .* 


Prototype:  STRUCTURE(STR)  [parameter]... 

Parameters : 

Output-  INDEX,  NOINDEX  Default:  NOINDEX 

Data 

The  INDEX  parameter,  when  given,  specifies  the  production 
of  an  index  to  the  report,  giving  the  pages  on  which  each 
undefined  name  used  in  the  report  occurs.  NOINDEX  specifies 
that  no  index  should  be  generated. 


Output-  URA  will  produce  structure  reports  for  the  following  name 
Option  types  when  given  as  parameters.  (Only  one  may  be  given  for 

each  report.) 

INPUT  (INP)  Default:  PROCESS 

OUTPUT (OUT) 

PROCESS  (PROC) 

INTERFACE  (INTF)* 

Output-  INDENT(lND)=integer  Default:  INDENT=3 

Format 

The  number  is  the  number  of  spaces  to  indent  each  succeeding 
level  in  the  report.  INDENT  must  take  on  some  value  greater 
than  0  and  less  than  11. 


Examples:  STRUCTURE 

STR  INPUT 


* 


*  REAL-WORLD-ENTITY  (RWE)  may  be  used  in  place  of  INTERFACE. 


! 
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Command : 


SUMMARY 


Default :  report  conmuuid 


Purpose: 
Prototype : 

Parameters : 

Examples : 


To  produce  the  DATA  BASE  SUMMARY  output. 
SUMMARY (SUM) 
no  parameters 


SUMMARY  l 

SUM 
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PART  V 

AUTOMATED  DOCUMENTATION  SYSTEM 

USERS'  MANUAL 
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INTRODUCTION 

- , - 

Whenever  an  organization  develops  an  information  system,  one  of 
the  major  problems  is  maintaining  it  over  its  life.  The  developers 
of  the  system  are  rarely  around,  or  available  to  help  the  maintenance 
group  in  their  task.  A  frequent  result  of  this  situation  is  a 
complete  redesign  and  redevelopment  of  the  system  to  make  relatively 
minor  modifications  to  the  system.  Such  practice  is  an  obvious 
waste  of  resources  that  could  have  been  avoided  with  proper  documen¬ 
tation.  While  the  above  is  a  strong  motivator  for  the  need  for 
documentation  standards,  there  are  other  advantages  involved,  namely, 
better  communication  between  developers  of  the  system,  easier 
training  of  new  employees,  etc.  Hence,  most  organizations  have 
developed  their  own  standards  which  must  be  adhered  to  for  document¬ 
ing  the  system.  Examples  of  such  standards  are  MILITARY  standards 
483  and  490  and  Department  of  Defense  Manual  4120. 17-M. 

Much  of  the  information  that  is  needed  in  the  final  document  describing 
the  system  may  be  obtained  during  the  system's  analysis,  design,  and 
construction  phases  of  the  development  life  cycle.  Therefore,  what 
is  needed  is  a  mechanism  that  will  allow  the  capture  of  the 

information  as  and  when  it  becomes  available  and  storing  it  in  a 

readily  usable  data  base.  This  is  where  the  URL/URA  data  base 

comes  into  the  picture. 

The  Automated  Documentation  System  basically  is  composed  of  three  parts. 
These  are  the  documentation  schema,  the  documentation  source,  and 
the  Analyzer  data  base.  These  areas  are  discussed  in  this  part. 
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1.0  Document  Initialization 


The  initialization  for  the  Automated  Documentation  System  must  be 
performed  for  each  project  to  be  documented.  This  task  may  be 
performed  by  the  project  leader.  It  involves  taking  the  Military 
Standard  and  deriving  from  them  relevant  headings  for  the  particular 
project  in  mind,  as  shown  in  the  example  (Appendix  F).  The  initializa-  • 
tion  allows  the  project  director  to  identify  the  major  and  detailed 
areas  of  documentation  to  be  produced  by  the  project  team  members.  It 
can  be  most  succinctly  expressed  as  the  table  of  contents  to  be  shown 
in  the  final  documentation.  In  addition,  the  project  manager  can  decide 
to  allow  for  up  to  three  generic  types  of  pages  such  as  figure,  appendices, 
etc.,  by  specifying  these  in  the  initialization.  The  details  of  the  syntax 
will  be  discussed  in  section  1.2.  Development  of  a  documentation  schema 
is  discussed  in  section  4.1.  Section  1.1  will  discuss  some  of  the  strategy 
to  be  followed,  and  the  general  initialization  process.  The  end  result  of 
the  initialization  process  is  a  documentation  object  schema. 

1.1' Strategy  for  the  document  initialization,  and  general  process 

There  are  basically  three  types  of  entries  that  may  be  entered  into 
the  documentation  schema.  An  entry  line  is  a  maximum  of  80  characters. 

The  entries  may  be  typed  in  on  cards,  or  other  media;  in  this  form  they 
are  known  as  documentation  source  schema.  When  these  same  entries  have 
been  entered  on  a  file  on  the  target  computer  which  also  has  the  Analyzer 
data  base  on  file,  the  entries  are  known  as  the  documentation  object  schema. 
The  process  of  converting  the  source  schema  into  the  object  schema  would 
generally  involve  nothing  more  than  reading  in  the  cards,  etc.  into 
a  file.  One  of  the  most  common  ways  of  doing  this  is  by  a  local 
text  editor,  or  some  other  file  populating  mechanism.  This  processor 
(editor,  etc.)  is  known  as  the  documentation  initializer  (Figure  65). 

The  three  types  of  entries  that  may  be  entered  into  the  documentation 
schema  are: 

-  the  table  of  contents; (SECTION  ENTRIES) 

-  formatting  commands  (TEXT  FORMATTING  ENTRIES) 

-  comments  (COMMENT  ENTRIES) 

The  table  of  contents  entries  are  all  preceded  by  a  distinguishing 
character,  which  must  be  entered  on  every  heading  to  appear  in 
the  table  of  . contents.  Formatting  commands  are  proceeded  by  the 
distinguishing  character 

Finally,  the  manager  may  want  to  insert,  into  the  documentation 
schema,  personal  comments  which  are  not  to  appear  in  the  final 
table  of  contents.  These  may  be  specified  by  a  followed  by  a 
comment  of  up  to  79  characters.  Should  the  comment  be  longer,  it 
may  be  started  on  the  next  line  but  preceded  by  another 
Comments  may  be  used  to  guide  the  documentors,  to  assign  specific 
portions  of  the  documentation  to  particular  individuals,  etc.  Any 

formatting  command  that  appears  in  the  schema  will  be  executed 

directly  before  the  .sectipn  ia  printecL  in  the  document.  This 

characteristic  will  be  discussed  infection  411. 
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Documentation 
Source  Schema 
(table  of  contents) 


Documentation 
Initializer 
(e.g.  Editor) 


Figure  65 
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1#2  Syntax  for  entries  in  the  Documentation  Schema 

SECTION-ENTRIES  have  the  following  syntax: 

#SECTION-IDENTIFIER  [HEADING-ENTRY ] 

The  section-identifier  must  be  preceded  by  a  "if"  in  column  1. 

The  section-identifier  is  the  unique  string  corresponding  to  that 
section  of  the  documentation  schema  (e.g.,  2.2.3).  This  String 
may  be  made  up  of  numbers,  characters  and/or  special  characters. 

No  particular  restrictions  are  placed  on  the  format  of  the 
identifier;  for  example,  an  identifier  of  1.2.a.l.b  is  a  perfectly 
legitimate  identifier.  The  section  entry  may  not  exceed  80 
characters.  It  is  important  to  note  that  there  must  be  at  least 
one  space  between  the  identifier  and  the  heading  entry.  The  final 
documentation  will  be  produced  in  the  order  that  the  identifiers 
were  entered  in  the  documentation  schema.  Hence,  it  is  the 
responsibility  of  the  individual  preparing  the  documentation  schema 
'to  enter  them  in  the  proper  order.  The  documentation  generator  will 
not  check  to  see  that  these  are  sorted.  The  section-identifier  is 
the  title  to  be  given  to  the  section.  This  is  the  title  that  will 
appear  in  the  final  document. 

TEXT- FORMATTING-ENTRIES  have  the  following  syntax: 

^CONTROL- INFORMATION-ENTRY 

The  text  formatting  commands  may  also  be  interspersed  anywhere 
in  the  schema,  but  must  be  preceded  by  a  in  column  1.  There 

are  two  types  of  formatting  commands.  One  type  controls  what  is 
going  to  be  done  at  a  certain  point  in  regards  to  spacing;  the 
other  type  controls  the  global  options  of  formatting. 

The  following  options  are  invoked  as  needed: 

*NEW-PAGE  -  Skip  to  the  top  of  the  next  page. 

*SKIP  [N]  -  Skip  N  lines.  If  N  is  greater  than  the  number  of 
lines  left  on  a  page,  then  this  command  causes  carriages 
to  skip  to  the  top  of  the  next  page.  N  defaults  to  1. 

^HOLD-BLANK  [N]  -  Check  to  see  if.  N  lines  are  left  on  this  page. 

If  there  are,  skip  N  lines.  If  there  are  not,  skip  to  the 
next  page  and  then  skip  N  lines.  This  option  insures  that 
enough  space  will  be  left  on  a  single  page  for  a  diagram 
or  able  to  be  written  in  manually.  N  defaults  to  1. 

*H0LD  [N]  -  The  rest  of  the  current  page  is  checked  to  see  if  N 
lines  are  left  on  the  page  (not  including  HEADING  or  BOTTOM¬ 
LINES).  If  N  lines  are  left,  the  next  line  of  the  source  data 
base  is  produced.  If  N  lines  are  not  left  on  the  current  page, 

skip  to  the  top  of  the  next  page  and  produce  the  next  line  of 
source.  Default  is  1. 

These  options  are  present  at  the  commencement  (under  their  default 
conditions  and  can  be  changed  throughout  the  source) : 
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*TITLE  ^«jitle}  “  a  given,  this  title  is  put  on  the  top 

of  each  page.  If  OFF  is  given,  no  title  is  printed  on  each 
page.  Default  is  OFF. 


♦HEADING  -  If  ON  is  specified,  the  HEADING-ENTRY  for  the 

V.  ON  J 

last  section  printed  is  put  at  the  bottom  of  each  page.  If 
OFF  is  specified,  the  HEADING-ENTRY  is  not  put  at  the  bottom 
of  each  page.  Default  is  ON. 


♦TOP-LINES  [N]  -  Skip  N  lines  at  the  top  of  each  new  page.  N 
defaults  to  3.  Range  is  from  0  to  10. 


♦BOTTOM-LINES  [N]  -  Skip  N  lines  at  the  bottom  of  each  page.  N 
defaults  to  2.  Range  is  from  0  to  10. 

♦LINES  [N]  -  N  is  the  number  of  lines  to  be  printed  on  a  page, 

including  Title  and  Heading.  N  defaults  to  60.  Range  is  from  5  to  60. 

♦SOURCE-MARGIN  [N]  -  N  is  the  number  of  spaces  to  indent  the 

actual  text  material.  This  does  not  effect  Analyzer  report 
indentation.  N  defaults  to  5.  Range  is  from  1  to  40. 


♦HEADING-MARGIN  [N]  -  N  is  the  number  of  spaces  to  indent  a  section 
heading  -  N  defaults  to  10.  Range  is  from  1  to  40. 

♦HEADING-SKIP  [N]  -  N  is  the  number  of  lines  to  skip  before 
printing  a  section-header.  The  amount  skipped  will  at 
most,  be  to  the  top  of  the  next  page.  N  defaults  to  2. 

I^ange  is  from  0  to  60. 

*REP0RT-CC^?F^-  When  set  to  ON,  the  Analyzer  report  carriage 
control1  is  engaged  when  outputting  Analyzer  reports.  This 
affects  page  feeding  of  the  document  produced.  When  OFF, 
the  line  skipping  and  page  feeding  is  controlled  by  only 
formatting  commands.  Default  is  ON. 

COMMENT-ENTRIES  have  the  following  syntax: 

&  COMMENT 


Comments  may  be  interspersed  anywhere  in  the  documentation  schema. 

They  will  not  appear  in  the  final  output.  The  »'&"  must  appear  in  column 
1.  The  comment  on  a  given  line  can  be  a  maximum  of  79  characters. 

There  is  no  limit  to  the  number  of  comment  entries  and  header  entries 
in  a  documentation  source  schema.  An  example  of  a  documentation 
source  schema  is: 

#2.  PROJECT  DEVELOPMENT  ENVIRONMENT/DOCUMENTATION  SYSTEM 
#2.1  DLVELOPMEN iAL  PHASES 
#2.1.1  INITIATION 


&  Til  ERE  SHOULD  BE  NO  NEED  TO  HAVE  ANY  OTHER  LTSTS  FOR  US. 
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(A  larger  example  is  in  appendix  F  1 


2.0  Documentation  data  base  population 


The  actual  documentation  to  be  written  would  probably  be  done  by 
more  than  one  individual.  These  individuals  may  enter  the  documen¬ 
tation  of  the  areas  they  are  responsible  for,  into  different  files, 
or  into  one  common  file  assigned  to  be-  shared  by  them.  In  the 
former  case,  the  documentation  manager  must  merge  the  different 
pieces  of  the  documentation  into  a  single  file.  The  order  of  this 
-file  is  not  important,  as  the  final  documentation  will  be  produced 
in  the  order  specified  by  the  documentation  schema  (see  section  1). 

2.1  Strategy  for  the  documentation  data  base  population 

It  is  important  that  the  individuals  who  are  going  to  document  the 
system  know  what  is  in  the  Analyzer  data  base.  They  should  be 
given  a  complete  NAME-LIST*  (or  NAME- GEN*)  of  names  in  the  Analyzer 
data  base,  and  have  either  a  FORMATT ED-P R0 BLEM-S TATEMENT* of  all 
these  names,  or  have  access,  via  a  terminal,  to  the  Analyzer  data  base 
in  order  to  easily  determine  what  is  already  in  the  Analyzer  data 
base.  For  example,  if  the  documentation  calls  for  the  description 
of  a  particular  input  (say  TEST-RESULTS) ,  this  should  be  in  the 
Analyzer  data  base,  and  the  documentor  should  be  required  to  invoke 
its  description  from  the  Analyzer  data  base  rather  than  to  have  to 
re-type  it.  This  has  two  obvious  advantages:  the  one  mentioned 
above  (reduction  of  redundant  work),  and  the  other  one  of  always 
having  an  up-to-date  description  of  the  item  of  interest.  It  is 
the  duty  of  the  project  manager  to  see  that  all  Analyzer  .entries 
have  been  made,  and  do  exist.  The  above  also  implies  that  the 
documentor  be  quite  familiar  with  the  use  of  the  Analyzer. 

m 

The  individuals  populating  the  documentation  data  base  must  also 
have  access  to  the  documentation  schema,  and  must  use  the  same 
section-identifiers  as  used  in  the  schema.  It  is  also  feasible 
to  have  a  limited  amount  of  text  formatting  capability  such  as 
getting  to  the  top  of  the  next  page,  or  skipping  to  next  half  page, 
etc.  This  capability  would  be  used  where  a  diagram,  or  table  (which 
could  not  be  drawn  by  the  documentation  generator)  had  to  be  inserted, 
and  room  had  to  be  left  for  it.  An  entry  line  for  the  documentation 
data  base  is  a  maximum  of  120  characters. 

To  distinguish  between  the  various  kinds  of  entries  in  the  documentation 
data  base,  Analyzer  entries  arc  preceded  by  a  "%n  in  column,  text¬ 
formatting  entries  are  preceded  by  a  in  column  1 ,  and  the 

actual  text  itself  has  nothing  preceding  it,  and  begins  in  column  1. 
Preceding  blanks  arc  considered  part  of  the  text.  An  entry  line  for 
the  documentation  data  base  is  a  maximum  of  120  characters. 
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The  documentation  data  base  may  be  populated  by  the  documentors  in 
much  the  same  way  as  the  documentation  schema  (Figure  66),  i.e., 

any  processor  such  cs  the  test  editor,  file  populator,  etc.,  may 
be  used  to  store  the  source  in  the  documentation  data  base  which  must 
be  a  file.  If  several  documentors  are  working  simultaneously, 
different  files  may  be  assigned  to  individual  documentors.  These 
portions  of  the  data  base  can  then  be  merged  at  documentation 
generation  time.  The  order  of  the  entries  is  unimportant. 

2.2  Syntax  for  the  Documentation  Data  Base 

SECTION-ENTRIES  have  the  following  syntax: 

^SECTION-  IDENTIFIER  [HEADING-COGENT] 

The  section  entries  are*  the  same  as  in  the  documentation  schema. 

•  However,  the  text  portion  (heading  comment)  in  the  documentation 
data  base  is  ignored.  Only  the  section-identifier  is  used  to  match 
‘\against  the  documentation  schema.  The  must  be  in  Column  1. 


ANALYZER-COMMAND-ENTRIES  have  the  following  syntax: 
%  ANALYZER-COMMAND 


Analyzer  commands  may  be  interspersed  anywhere  in  the  text  with 
the  provision  that  they  be  preceded  by  a  in  column  1.  Any 
Analyzer  commands  from  Part  TV  are  allowed 

except  the  STOP  command  and  the  SET  command  with  the  option 
PR0MPT=0N  in  effect  (by  default  it  is  not  in  effect) .  The 
commands  are  not  executed  immediately.  They  are  just  stored 
as  is  until  the  documentation  generation  process. 


TEXT- FORMATTING-ENTRIES  have  the  following  syntax: 
*  CONTROL-INFORMATION-ENTRY 


The  text  formatting  commands  available  to  use  in  the  schema  will 
also  be  available  to  use  in  the  source.  They  may  be  interspersed 
anywhere  in  the  documentation  source.  The  must  again  be  in 
column  1. 


*  Part  IV, 
Description  " 


•  ’’ ••-’ui  repents  .‘•nnly/,.or  Command 
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Documentation 

Source 


Documentation  data 
base  populator 
(e.g.  Editor) 


Documentation 
Data  Base 
(file) 


Figure  66 


COMMENT- ENTRIES  have  the  following  syntax: 


{■COMMENT 


Comments  may  be  interspersed  anywhere  in  the  documentation  source. 
They  will  not  appear  in  the  final  output  (same  as  in  the  schema). 

The  "fir"  must  be  in  column  1. 

In  the  documentation  source,  the  line  size  maximum  is  120  characters. 
Text  entries  have  no  specific  format. 

3.0  The  Documentation  Generation 


The  documentation  generation  may  be  performed  by  the  project  manager 
when  one  wishes  to  have  the  completed  documentation.  The  manager  may 
first  wish  to  ascertain  that  the  documentation  is  indeed  complete.  It 
is  possible  for  the  manager  to  find  this  out.  However,  the  extent  of 
’checking  is  limited  to  the  absense,  or  presence  of  an  entry  in  the 
data  base  corresponding  to  every  entry  in  the  schema.  There  is  no 
check  to  find  out  if  the  corresponding  Analyzer  data  base  entries 
also  exist. 

The  manager  also  has  the  flexibility  of  specifying  which  data  base, 
and  schema  are  to  be  considered.  If  one  should  so  desire,  the 
generator  will  produce  only  the  table  of  contents. 

If  the  manager  finds  that  all  entries  in  the  schema  have  corresponding 
entries  in  the  data  base,  one  can  now  go  ahead  and  ask  the  generator 
to  produce  the  final  documentation  as  per  the  specification  in  the 
schema.  Optionally,  a  title  may  be  specified  on  the  final  document. 

The  manager  must  realize  that  this  will  be  a  lengthy  process,  as  it 
involves  the  invocation  of  several  analyzer  commands,  the  generation 
of  intermediate  files,  and  the  merging  of  several  files  to  produce  the 
final  documentation  (Figure  67)#  Hence,  it  is  recommended  that  this 
be  done  in  batch  mode.  However,  because  the  Analyzer  processor  is 
being  run  when  the  documentation  is  desired,  it  will  be  using  the  latest 
version  of  the  descriptions,  etc.,  that  are  available. 

The  process  that  the  Documentation  Generator  goes  through  is  shown  in 
Figure  67  It  involves  two  steps.  Phase  I  (CHECK)  checks  to  see  what 
Section  Entries  in  the  schema  are  present  in  the  documentation  source. 

It  also  extracts  all  Analyzer  commands  from  the  source  and  writes  them 
into  a  seperate  file  to  be  used  as  input  to  the  Analyzer.  Phase  II 
(MERGE)  merges  the  output  from  the  Analyzer  with  the  documentation  source 
and  produces  the  document.  It  is  at  this  point  that  the  text  formatting 
commands  are  processed. 

The  procedure  for  documentation  generation  is  dependent  on  the  operating 
system  under  which  the  Automated  Documentation  System  is  installed.  Hence 
there  is  no  one  way  to  invoke  the  Automated  Documentation  System.  Appendix  h 

will  include  the  system  dependent  information  required  to  execute  the 

Automated  Documentation  System  and  generate  a  document. 
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4.0  Usage  of  the  Documentation  Generator 


In  using  the  documentation  generator,  there  are  several  areas  that 
need  to  be  considered  in  order  to  achieve  a  desired  quality  level. 
Coordination  between  the  schema,  source  and  Analyzer  data  base  are 
mandatory  in  order  to  develop  a  document  which  will  contain  complete 
information.  Development  of  the  methods  to  produce  these  three  inputs 
into  the  system  so  that  they  can  be  used  in  an  on-going  way  (camera- 
ready  documentation)  is  the  topic  of  this  section.  Considerations 
as  to  what  should  be  included  in  each  component,  what  pitfalls  should 
be  watched  out  for,  and  what  variations  might  arise  in  usage  of  the 
documentation  generator  will  be  discussed.  It  is  important  for 
the  reader  to  realize  at  this  point  that  while  this  system  has  been 
developed  to  provide  a  generalized  format  for  producing  documents 
under  a  set  of  standards,  the  system  still  allows  a  great  deal  of 
flexibility  to  the  user. 

Department  of  Defense  Manual  4120. 17-M  along  with  MIL  Standard  483 
wi^l  be  used  as  example  documentation  standards  in  this  discussion. 
Development  of  a  Functional  Description  and  Data  Requirements  Document 
of  the  Pay  system  Analyzer  data  base  (W.P.  74*)  will  b<?  used  as  a 
specific  example  (Appendix  F). 

4.1  Development  of  the  Documentation  Schema 

The  documentation  schema  consists  of  a  structural  outline  or 
table  of  contents  of  the  particular  document  being  produced.  From 
this  schema  a  table  of  contents  for  the  document  being  generated 
will  be  produced.  Hence,  it  is  important  that  the  user  include 
enough  section  levels  in  order  to  make  the  table  of  contents 
meaningful.  It  is  also  important  to  note  that  the  final  documenta¬ 
tion  will  be  produced  in  the  order  stated  in  the  documentation 
schema,  so  the  schema  should  be  set  up  appropriately. 

Format  for  the  schema  is  discussed  in  section  1.  The  documentation 
initializer  (see  Figure  65)  takes  the  documentation  schema  and 
produces  a  documentation  object  schema,  which  is  stored  permanently 
on  file  after  any  require  editing  is  done. 

Within  the  schema,  formatting  commands  are  allowed.  The  schema  is 
checked  to  see  if  it  contains  any  formatting  commands.  If  it  does, 
each  formatting  command  goes  into  effect  prior  to  the  printing  of  the 
section  header  and  immediately  following  the  formatting  command. 

This  is  also  true  for  commands  at  the  beginning  of  the  schema. 


Although  it  is  suggested  that  the  table  of  contents  of  a  particular 
document  or  standard  be  used  as  the  schema,  many  tines  a  more 
detailed  schema  is  warranted.  Situations  where  more  or  less  detail 
might  be  deemed  necessary  are  in  the  following  subsections. 


*  "An  Example  of  the  Use  of  URL  Using  Top-Down  Analysis." 


4.1.1  Where  less  detail  might  be  necessary 


The  table  of  contents  of  a  certain  standard  is  a  skeleton  type 
set  up,  giving  suggestions  on  how  the  documents  should  be 
developed,  'but  leaving  room  for  variances  in  structure  from 
one  document  to  another  written  according  the  standard.  In 
this  case  it  might  be  wise  to  use  less  detail  in  the  schema 
and  keep  it  as  general  as  possible. 


An  example  of  where  this  situation  arises  is  in  MIL  standard  483. 
In  Section  3.2,  the  standard  sets  up  the  criteria  for  describing 
each  separate  function  of  a  system.  Since  there  is  going  to  be 
a  varying  number  of  functions  in  different  systems,  the  standard 


sets  up  the 

description  then  as  follows: 

3.2.X 

Function  X 

3.2.X.1 

INPUTS 

3.2.X.2 

PROCESSING 

3. 2.X. 3 

OUTPUTS 

Thus,  this  basic  structure  is  repeated  for  every  function  in 
the  system.  This  causes  a  definite  problem  when  using  the  document 
generator.  Since  it  is  desirable  to  have  one  schema  for  all  docu¬ 
ments  produced,  it  can  be  seen  that  since  the  number  of  functions 
will  vary  from  one  system  to  the  next,  the  standard’s  table  of 
contents  cannot  be  followed  strictly. 

Three  options  are  open  to  the  documentor  in  cases  like  this. 

a.  Include  in  the  schema  only  the  section  header  ( // 3 . 2  DETAILED 
FUNCTIONAL  REQUIREMENTS)  and  leave  the  rest  to  be  described 
in  the  source.  Comment  entries  could  be  included  in  the 
schema  to  describe  what  should  be  included  with  these.  The 
advantage  of  this  option  is  that  the  schema  will  be  constant 
and  independent  of  each  instance  of  this  document.  The  dis¬ 
advantage  is  that  the  schema  will  now  lack  information  and 
the  table  of  contents  will  be  somewhat  incomplete. 

#3.2  DETAILED  FUNCTION  REQUIRMENTS 
&  PARAGRAPH  3.2X  FUNCTION  X. 

&  THE  BASIC  PARAGRAPH  FOR  EACH  FUNCTION  SHALL  BEGIN  WITH 

&  DESCRIPTIVE  AND  INTRODUCTORY  MATERIAL  WHICH  DEFINES  THE 

&  FUNCTION  AND  ITS  RELATIONSHIP  TO  OTHER  FUNCTIONS.  THEN,  THE 
&  FOLLOWING  THREE  SUBPARAGRAPHS  SHALL  SPECIFY  THE  QUALITATIVE 
&  REQUIREMENTS  CONCERNING  THE  FUNCTION. 

&  PARAGRAPH  3.2.X.1  INPUTS. 

&  PARAGRAPH  3.2.X.2  PROCESSING. 

&  PARAGRAPH  3.2.X.3  OUTPUTS. 


b.  Set  up  the  schema  in  the  following  way: 


H 3.2.1 
#3. 2.1.1 
#3. 2. 1.2 

//  3. 2. 1.3 
#3.2.2 
//  3 . 2 . 2 . 1 
113.2.2.2 
i'2.2.2.3 


FUNCTION  ONE 

INPUTS 

PROCESSING 

OUTPUTS 

FUNCTION  TWO 

INPUTS 

PROCESSING 

OUTPUTS 


03.2.12 

03.2.12.1 

03.2.12.2 

03.2.12.3 


FUNCTION  TWELVE 
INPUTS 
PROCESSING 
OUTPUTS 


The  advantage  of  this  option  is  that  the  table  of  contents  is 
complete.  The  disadvantage  is  that  the  entries  in  the  table 
are  not  meaningful. 

c.  Include  in  the  schema  the  actual  function  names  for  each 
system.  An  example  of  this  would  be: 


#3.2  DETAILS!)  'FUNCTION  REQUIREMENTS 

#3.2.1  SENSOR  CALIBRATION  (INITIAL)  FUNCTION 

#3.2.1 . 1  INPUTS 

#3.2.1 .2  PROCESSING 

#3.2. 1  .3  OUTPU  To 

..  #3.2.2  ELEMENT  CORRECTION  (INITIAL)  FUNCTION 
''#3.2.2. I  INPUTS 
#3. 2. 2. 2  PROCESSING 
#3. 2. 2. 3  OUTPUTS 

#3.2.3  MANEUVER  DETERMINATION  CONTROL  FUNCTION 
#3.2.3. I  INPUTS 
#3. 2. 3. 2  PROCESSING 
#3.2.3. 3  OUTPUTS 

#3.2.4  SIMULTANEOUS  SOLUTION  OF  MANEUVER  AND  ELEMENTS  FUNCTION 
#3.2.4. I  INPUTS 
#3. 2. 4. 2  PROCESSING 
#3. 2. 4. 3  OUTPUTS 

#3.2.5  ELEMENT  MAINTENANCE  CONTROL  FUNCTION 
#3.2.5. I  INPUTS 
#3. 2. 5. 2  PROCESSING 
#3.2.5 .3  OUTPUTS 

#3.2.6  ELEMENT  CORRECTION  (ROUTINE)  FUNCTION 
#3.2.6. I  INPUTS 
#3. 2. 6. 2  PROCESSING 

#3. 2. 6. 3  OUTPUTS  . .  ' 

#3.2.7  OBSERVATION  EDITING  FUNCTION 
#3.2.7. I  INPUTS 
# 3. 2 .7.2  PROCESSING 
#3.2.7. 3  OUTPUTS 

#3.2.6  SENSOR  CALIBRATION  (ROUTINE)  FUNCTION 
#3.2.6. I  INPUTS 
#3. 2. 6. 2  PROCESSING 
#3. 2. 6. 3  OUTPUTS 

#3.2.9  ELEMENT  RECOVERY  CONTROL  FUNCTION 
#3.2.9. I  INPUTS 
#3. 2. 9. 2  PROCESSING 
#3. 2. 9. 3  OUTPUTS 

•“3.2.10  ELEMENT  CORRECTION  (RECOVERY)  HJ  MOTION 

#3.2.10.1  HPDTS 
#3.2.10.2  PROCESSING 

#3.2.10.3  OUTPUTS 
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#3.2.11  MANEUVER  DETECTION  FUNCTION 
#3.2.11.1  INPUTS 
#3.2.11.2  PROCESSING 
#3.2. I  I .3  OUTPUTS 

#3.2.12  MANUAL  INTERACTIVE  DIFERRENTI AL  CORRECTION  FUNCTION 
#3.2.12.12  INPUTS 
#3.2.12.2  PROCESSING 

#3.2. 12.3  OUTPUTS  '  ‘ 


The  advantage  of  this  method  is  that  the  schema  is  complete 
and  descriptive.  The  disadvantage  is  that  the  schema  will 
have  to  be  changed  for  each  application  document. 

Hie*  decision  as  to  which  one  of  these  options  should  be  used 
is  up  to  the  disgression  of  the  user. 
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A. 1.2  Where  more  detail  might  be  necessary 

If  within  the  standard,  references  are  made  to  information  that 
is  deemed  necessary  to  include  within. a  certain  section,  it 
might  be  advisable  to  include  this  information  in  the  schema. 

An  example  of  this  would  be  in  the  Data  Requirements  Document 
of  D.O.D.  Manual  A120-17-M.  In  this  document,  the  table  of 
contents  looks  as  follows: 

1.  GENERAL  DATA  REQUIREMENTS 

1.1  PURPOSE  OF  DATA  REQUIREMENTS 

1.2  PROJECT  REFERENCES 

1.3  MODIFICATION  OF  DATA  REQUIREMENTS 

2.  DATA  DESCRIPTION 

2.1  LOGICAL  ORGANIZATION  OF  STATIC  SYSTEM  DATA 

2.2  LOGICAL  ORGANIZATION  OF  DYNAMIC  INPUT  DATA 

2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 
2. It  INTERNALLY  GENERATED  DATA 

2.5  SYSTEM  DATA  CONSTRAINTS 

3.  USER  SUPPORT  FOR  DATA  COLLECTION 

3.1  DATA  COLLECTION  REQUIREMENTS  AND  SCOPE 

3.2  RECOMMEND  SOURCE  OF  INPUT  DATA 

3.3  DATA  COLLECTION  AND  TRANSFER  PROCEDURES 
3. A  DATA  BASE  IMPACTS 

Within  Section  3.1,  the  standard  refers  to  nine  areas  of 
supplementary  information.  If  this  information  is  considered 
to  be  of  such  a  nature  that  it  will  be  included  in  most  all  the 
documents  being  produced,  the  user  might  want  to  include  the 
information  in  the  schema  (therefore  in  the  table  of  contents 
of  the  document).  The  schema  would  then  look  like: 


#1.  GENERAL  data  requirements 
#1.1  PURPOSE  OF  DATA  REQUIREMENTS 
#1.2  PROJECT  REFERENCES 
#1.3  MODIFICATION  OF  DATA  REQUIREMENTS 
#2.  DATA  DESCRIPTION 

#2.1  LOGICAL  ORGANIZATION  OF  STATIC  SYSTEM  DATA 

#2.2  LOGICAL  ORGANIZATION  OF  DYNAMIC  INPUT  DATA 

#2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 

#2. A  INTERNALLY  GENERATED  DATA 

#2.5  SYSTEM  DATA  CONSTRAINTS 

#3.  USER  SUPPORT  FOR  DATA  COLLECTIONS 

#3.1  DATA  COLLECTION  REQUIREMENTS  AND  SCOPE 


#3.1.1 

INPUT  SOURCE (S)  OF  THE  DATA  ELEMENT 

#3.1.2 

INPUT  MEDIUM 

#3.1.3 

RECIPIENTS 

#3.1.4 

CRITICAL  VALUE 

#3.1.5 

SCALES  OF  MEASUREMENT 

'■#3.1.6 

CONVERSION  FACTORS 

#3.1.7 

OUTPUT  FORM/DEVICE 

#3.1.8 

EXPANSION  FACTORS 

#3.1.9 

FREQUENCY  OF  UPDATE 

#3.2  RECOMMEND  SOURCE  OF  INPUT  DATA 

#3.3  DATA  COLLECTION  AND  TRANSFER  PROCEDURES 

#3. A  DATA  BASE  IMPACTS 

It  might  be  that  the  documentor  just  needs  to  be  reminded 
of  the  supplementary  information.  In  this  case  it  might  be 
appropriate  just  to  include  an  appropriate  comment. 

#1.  GENERAL  DATA  REQUIREMENTS 
#1.1  PURPOSE  OF  DATA  REQUIREMENTS 
#1.2  PROJECT  REFERENCES 
#1.3  MODIFICATION  OF  DATA  REQUIREMENTS 
#2  DATA  DESCRIPTION 

#2.1  LOGICAL  ORGANIZATION  OF  STATIC  SYSTEM  DATA 

#2.2  LOGICAL  ORGANIZATION  OF  DYNAMIC  INPUT  DATA 

#2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 

#2. A  INTERNALLY  GENERATED  DATA 

#2.5  SYSTEM  DATA  CONSTRAINTS 

#3.  USER  SUPPORT  FOR  DATA  COLLECTION 

#3.1  DATA  COLLECTION  REQUIREMENTS  AND  SCOPE 

&  AT  THIS  POINT  IT  SHOULD  BE  NOTICED  THAT  THERE  ARE  NINE  AREAS 
&  TO  BE  CONCERNED  WITH  IN  THIS  SECTION.  THEY  ARE: 

&  A.  INPUT  SOURCE (S)  OF  THE  DATA  ELEMENT 

&  B.  INPUT  MEDIUM 

&  C.  RECIPIENTS 

&  D.  CRITICAL  VALUE 

&  E.  SCALES  OF  MEASUREMENT 

fi>  F.  CONVERSION  FACTORS 

&  C.  OUTPUT  FORM/ HI'. VICE 

&  H.  EXPANSION  FACTORS 

&  I.  FREQUENCY  OF  UPDATE 

# 3.2  RECOMMEND  SOURCE  OF  INPUT  DATA 

#3.3  DATA  COLLECTION  AND  TRANSFER  PROCEDURES 

#3. A  DATA  BASE  IMPACTS 
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The  decision  as  to  what  should  be  in  the  schema  is  based  primarily 
on  how  much  detail  is  wanted  and/or  expected  in  the  table  of 
contents • 

4.2  Development  of  the  Documentation  Source  Data  Base 

The  format  of  the  documentation  source  and  a  description  of  how  it 
is  transformed  into  the  documentation  data  base  is  in  Section  2. 
There  are  several  areas  that  the  user  need  be  aware  of  when 
developing  the  documentation  data  base.  Proficiency  in  these  areas 
is  necessary  if  the  documentor  is  to  attain  full  range  capabilities 
of  the  document  generator. 

4.2.1  Knowledge  of  the  Analyzer  Data  Base 

•  It  is  of  utmost  importance  that  the  documentor  have  a  thorough 
knowledge  of  the  Analyzer  data  base  as  well  as  the  Analyzer 
‘  \command  language.  The  documentor  must  be  able  to  pick  out  the 
information  needed  for  the  document.  When  it  is  known  that  a 
system  will  have  to  be  documented  using  a  certain  standard,  it 
is  also  important  that  the  person  developing  the  Analyzer  data 
base  have  a  full  understanding  of  what  information  is  needed  to 
fulfill  the  standard’s  documentation  requirements.  Since  the 
standard  usually  requires  complete  information  about  the  system, 
writing  the  Analyzer  data  base  with  the  standard  in  mind  will 
usually  serve  to  insure  a  complete  system  description. 

4.2.2  Text  Material 

The  documentation  source  data  base  for  various  projects  written 
under  a  certain  standard  should  be  developed  in  such  a  way 
as  to  minimize  the  differences  in  the  various  Source  data  bases. 
This  can  cut  down  substantially  on  the  documentor’s  time  spent 
on  each  system.  Another  advantage  of  doing  this  is  that  once  a 
certain  combination  of  commands  has  been  determined  as  the  best 
way  to  convey  certain  information  required  by  a  particular 
standard,  then  that  combination  can  be  repetitively  used  for 
all  projects  documented  under  this  particular  standard. 

With  this  in  mind,  the  documentor  should  try  to  include  in  the 
source  only  such  text  that  will  be  present  in  every  instance 
of  the  document  being  produced.  Examples  of  such  text  are  in 
paragraphs  found  in  both  the  Functional  Description  and  Data 
Requirements  Documents.  These  paragraphs  describe  the  purpose 
of  each  of  the  documents: 

Section  1.1 

This  Functional  Description  for  (Project  Name)  (Project 

Number)  is  written  to  provide: 

a.  The  system  requirements  to  be  satisfied  which  will 
serve  as  a  basis  for  mutual  understanding  between 
the  user  and  the  developer. 
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b.  Information  on  performance  requirements,  preliminary 
design,  and  user  impacts,  including  fixed  and  continuing 
costs. 

I 

c,  A  basis  for  the  development  of  system  tests. 


Section  1.1 

» 

t  This  objectives  of  this  Data  Requirements  Document  for 
(Project  Name)  (Project  Number)  are  to  list  and  define 
data  elements  which  the  system  must  handle  and  to 
communicate  data  collection  requirements  to  the  user. 

Another  example  of  where  text  should  be  used  is  when  a 
common  segment  is  being  described.  An  example  of  this  is 
.  Section  3.3  of  the  Functional  Description.  Here  is  an  example 
of  how  the  source  might  look: 

''  #3.3  INPUTS /OUTPUTS 

INPUTS: 

%NG  INPUT  NOPRINT 

%FPS 

ZSKIP  2 

OUTPUTS : 

%NG  OUTPUT  NOPRINT 
%FPS 

ZSTR  OUTPUT 

Since  the  documentation  source  data  base  will  be  different  for 
each  project  documented,  it  is  not  necessary  that  the  text  be 
constant.  However,  this  practice  reduces  redundancy  in  work 
done  by  the  documentor. 

A. 2. 3  Analyzer  Commands 

As  mentioned  before,  the  documentor  must  have  a  full  understanding 
of  the  Analyzer  command  capabilities  (described  in  Part  IV*) 

including  all  possible  options.  This  knowledge  is 
essential  for  the  document  generator  to  produce  complete  information 
in  a  readible  form.  Some  of  the  commands  and  options  that  might  be 
useful  are  listed  below: 


PCOM 

Options : 

DESCRIPTION 

NOPUNCH 

NG 

Options : 

SUBLEVEL=# 
SUBPART-0 F=NAME 
NOPRINT, PRINT 

CONTENTS 

** 

KEY=keyword-name 

PICTURE 

Options : 

NOL>A  iVv 

NO FLOW 
NOSTKUCTURE 

"User  Requl roments  Analyzer  Command  Descrip- 
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Part  IV, 

tiens1; 


The  Data*Process  Report  could  be  very  beneficial,  especially 
since  it  produces  a  very  complete  description  of  data  flow 
and  process  functions.  It  can  be  used  when  an  overall  interaction 
description  is  needed.  This  report  also  shows  if  consistency 
is  present  as  well  as  showing  completeness  (or  incompleteness). 

The  STOP  command  should  not  be  used.  There  are  three  options  of 
the  SET  command  that  should  not  be  used:  PROMPT=ON  will  virtually 
destroy  the  document  being  produced.  It  is  also  recommended  that 
OUTPUT=XXX,  HEADING=ON,  PARM=ON  not  be  used.  (All  four  of  these 
options  default  to  OFF.) 

4. 2. A  Formatting  Entries 

As  shown  in  Section  2.2,  the  text  formatting  entries  allow  the 
user  a  great  deal  of  maneuverability  in  regards  to  the  final 
document  format.  At  this  point,  a  diagram  might  help  to  show 
-  *  *,  just  what  is  going  on  a  page  of  a  document. 


top-lines 


LINES 


bottom¬ 

lines 
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It  is  important  for  the  documentor  to  understand  the  formatting 
commands.  There  are  several  points  that  should  be  remembered 
when  using  the  commands.  These  are  covered  in  the  following  sub¬ 
section. 

4. 2. 4.1  Defaults  of  Formatting  Commands 


The  formatting  options  can  be  changed  at  any  time  in  the 
Source.  The  formatting  commands  default  affect  how  the 
document  will  appear.  If  one  does  not  specify  a  value 
for  these  commands,  then  the  defaults  will  be  used.  When 
the  documentor  does  not  specify  these  command  values,  then 
the  final  document  will  appear  as  if  the  defaults  were 
included  in  the  Source  data  base.  The  formatting  command 
defaults  are: 


*  REPORT-CC  ON 

*  TITLE  OFF 

*  HEADING  ON 

*  TOP-LINES  3 

*  BOTTOM-LINES  2 

*  LINES  60 

*  SOURCE-MARGIN  5 

*  HEADING-MARGIN  5 

*  HEADING-SKIP  2 

% 

The  last  occurrence  of  each  option  is  the  one  in  effect. 

4. 2. 4. 2  Analyzer  Report  Indentation 

Analyzer  report  indentation  is  not  affected  by  either  HEADING- 
MARGIN  or  SOURCE-MARGIN.  Care  must  be  taken  in  setting  these 
two  options  so  the  document  being  produced  is  in  a  logical 
readible  format. 

4. 2. 4. 3  LINE  SKIPPING 

HEADING-SKIP  reacts  the  same  way  as  SKIP  does  when  an  end  of 
page  is  encountered.  Also,  the  documentor  should  be  careful 
when  trying  to  set  up  a  section-header  so  it  starts  on  a  new 
page.  (The  combination  of  NEW-PAGE  with  a  HEADING-SKIP  will 
cause  the  Section-Identifier  not  to  be  printed  at  the  top 
of  the  new  page.  If  the  value  of  SKIP  or  HEADER-SKIP  is  more 
than  the  current  LINES  values  then  the  generator  automatically 
skips  to  the  top  of  the  next  page. 

4. 2. 4. 4  Usage  of  REPORT-CC 

Usage  of  the  REPORT-CC  command  will  have  a  direct  bearing 
on  the  paging  of  the  document  being  processed.  Since  when 

REPORT-CC  is  ON,  analyzer  reports  will  be  produced  according 
to  their  normal  paging  sequence.  This  is  helpful  when  a 
PICTURE  Report  is  being  produced  and  more  then  one  name  is  input 
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or  the  PICTURE  must  be  continued  on  the  next  page.  Other 
reports  where  this  option  is  helpful  are  the  DATA  PROCESS 
Report  and  the  CONSISTS-COMP ARISON  MATRIX  Report.  In  cases 
where  a  report  will  be  taking  up  more  than  one  page  it  is 
important  to  start  the  report  at  the  top  of  a  fresh  page 
so  that  the  Analyzer  paging  will  match  the  documentation 
generator's  paging.  There  are  cases,  though,  where  the 
documentor  will  wish  to  set  REPORT-CC  OFF,  such  as  where 
several  names  are  being  entered  into  the  FPS  Report  or 
CONTENTS  Report. 

4. 2. 4. 5  The  HOLD  and  HOLD- BLANK  Commands 

The  documentor  should  understand  the  usefulness  of  the  HOLD 
and  HOLD-BLANK  commands.  If  a  diagram,  table  or  figure  must 
be  drawn  manually,  the  HOLD- BLANK  command  should  always  be 
used.  This  will  insure  enough  space  is  saved  on  one  complete 
page  to  insert  the  figure.  If  an  analyzer  report  or  some  text 
material  is  going  to  be  produced  and  the  documentor  wishes  that 
this  material  be  contained  on  one  page,  the  HOLD  command  should 
be  used.  An  example  of  where  it  would  be  used  is  with  the  PICTURE 
Report.  Since  the  PICTURE  Report  uses  40  lines^  the  documentor 
should  place  a  HOLD  40  preceding  the  PICTURE  command  to  insure 
that  it  is  produced  on  a  single  page. 

4.2.5  Usage  of  Analyzer  SYNONYMS  *  ' 

A  SYNONYM  is  a  short  abbreviation  form  of  a  name  that  can  be 
stored  in  the  Analyzer  data  base.  A  SYNONYM  is  a  reserve 
word  of  the  Analzer. 

In  order  to  generalize  the  documentation  Source  data  base, 

SYNONYMS  should  be  used  whenever  possible  to  describe  certain 
items,  such  as  main  functions,  master  files,  etc.  The 
implication  of  this  practice  on  the  Analyzer  data  base 
formulation  is  discussed  in  section  4.3.2. 

By  using  SYNONYMS,  the  documentor  is  relieved  of  changing 
even  more  of  the  Source  data  base  from  one  project  to  the 
next.  An  example  of  how  this  can  be  done  is  in  Section 
3.2  of  the  Functional  Description.  The  Source  data  base 
will  look  as  follows: 

03.2  SYSTEM  FUNCTIONS 

%NG  SO=MAIN-PROCESS  SL=1  NOPRINT 

THE  VARIOUS  SUB-FUNCTIONS  OF  THE  SYSTEM  ARE: 

%PCOM  DESC  PRCI)  NOPUNCH 

In  this  example,  MAIN-PROCESS  is  a  SYNONYM. 
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Section  2. A. 2. A  is  another  example. 

< 

#2. A. 2. A  OPERATIONAL  IMPACTS 

A.  OPERATIONAL  STRUCTURE 

ZSTR 
*SKIP  2 

B.  TIMELINESS (OPERATIONS  AND  DATA) 

ZFREQ 
*SKIP  2 

C.  INPUTS 
ZSTR  INPUT 
*SKIP  2 

D.  DATA  RETENTION 
1.  MASTER  FILE 

ZPCOM  N=MAS TER- FILE  DESC  DER  NOPUNCH 
*NEW-PAGE 

ZPIC  N=MASTER-FILE  NODATA  NOFLOW 
S  Here,  MASTER-FILE  is  a  SYNONYM. 


A. 3  Development  of  the  Analyzer  Data  Base  with  the  Document  Generator 

in  Mind* 


There  are  two  situations  that  can  occur  in  relation  to  the  Analyzer 
data  base  when  using  the  Document  Generator. 

The  Analyzer  data  base  has  either  been  written  with  the  document 
to  be  produced  in  mind,  or  it  has  not  been.  In  any  case,  it  is 
going  to  be  beneficial  for  the  documentor  to  write  or  update  the 
Analyzer  data  base  in  such  a  way  as  to  facilitate  ease  of  produc¬ 
tion  of  the  document  using  the  generator.  Various  practices  can 
be  used  by  the  documentor  to  accomplish  this.  These  practices 
are  explained  in  the  following  sub-sections. 

A. 3.1  Usage  of  MEMO 

When  it  is  necessary' to  describe  certain  aspects  of  a  proposed 
system  that  arc  general  in  nature  but  do  not  apply  directly  to 
the  structural,  functional,  or  data  flow  of  the  system,  then 
the  usage  of  MEMOs  in  the  Analyzer  data  base  can  be  very  helpful. 
When  objectives,  background  material,  requirements,  impacts,  etc., 
are  needed,  a  MEMO  is  the  obvious  answer.  Hence,  simple 
PUNCH-COMMENT-ENTRY  is  all  that  is  needed  in  the  documentation 
source.  An  example  of  a  typical  MEMO  is  shown  below.  This 
MEMO  relates  the  objectives  required  for  Section  2.2  of  the 
Functional  Description: 


*  Note:  All  capitalized  names  in  this  section  refer  to  URL  Reserve 

Words.  For  a  more  detailed  explanation,  refer  to  ISDOS 

Working  Papers  No.  68  and  No.  98. 
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OBJECTIVES-MEMO; 


MEMO  #  * 

DESCRIPTION; 

THIS  PROJECT  HAS  BEEN  AUTHORIZED  TO  DEVELOP  A  PAY  SYSTEM 
FOR  THIS  ORGANIZATION.  THIS  PAY  SYSTEM  WILL  PERFORM  PAYROLL 
PROCESSING  USING  EMPLOYEE  INFORMATION  COMING  FROM  DEPART¬ 
MENTS  AND  EMPLOYEES  AND  WILL  PRODUCE  OUTPUTS  WHICH  WILL  GO 
TO  THE  DEPARTMENTS  AMD  EMPLOYEES.  THE  SYSTEM  WILL  ALSO 
MAINTAIN  THE  PAYROLL  MASTER  INFORMATION.; 


4.3.2  Usage  of  NAMES  and  SYNONYMS 

When  the  documentor  is  constructing  Analyzer  data  bases,  one  should 
keep  in  mind  what  Analyzer  NAMES  and  SYNONYMS  have  been  used  in 
previous  documentation  Source  data  bases.  The  documentor’s  work 
can  be  reduced  if  common  names  are  used  to  describe  similar  sections 
of  Analyzer  data  bases  which  are  describing  systems  that  will 
have  to  be  documented  under  the  same  standard.  For  instance,  a 
'"documentor  might  want  to  include  sections  called  BACKGROUND-MEMO 
and  OBJECTIVE-MEMO  when  developing  Analyzer  data  bases  to  be 
documented  using  the  Functional  Description  Standards.  The 
documentor  might  also  want  to  have  an  ATTRIBUTE  named  DEVELOPMENT- 
TIMES  in  these  Data  Bases.  An  examples  of  ATTRIBUTE  usage  follows: 

DEFINE  DEVELOPMENT-TIMES 

AS  A  ATTRIBUTE; 

/*  VALUES  ARE: 

MAN-H0URS-120 


FOR 

PLENTY  FOR 
MAN-HOURS-lOO 

PROGRAMMING, 

COMPUTER-TIME, 

FOR 

MAN-H0URS-20 

DATA-BASE-DEVELOPMENT 

FOR 

MAN-HOURS- 30 

PAYROLL-CLERICAL, 

FOR 

OPERATIONS , 

*/ 

* 

SYNONYMS  can  be  used  in  similar  fashion.  If  the  documentor 
uses  similar  synonyms  in  each  data  base,  his  editing  can  be 
reduced.  Examples  of  this  are  using  MASTER-FILE  as  a  SYNONYMS 
for  the  main  file  of  the  system  and  using  MAIN-PROCESS  as  a 
synonym  for  the  highest  level  function  in  the  system. 

4.3.3  Completeness 

There  are  three  areas  in  which  the  documentor  should  strive  to 
achieve  completeness  in  the  Analyzer  data  base.  These  areas 
are  data  flow,  system  structure,  and  functional  flow. 

Data  flow  should  be  complete  in  that  all  files  or  data  sets  are 

accounted  for.  This  means  that  data  definition  should  be 
included.  Elements  of  data  sets  need  be  defined  only  to  the 
level  of  description  required.  The  CONTENTS  Report  is  a  good 
means  of  chocking  data  description  completeness.  Usage  of 
UPDATES,  DERIVES,  GENERATES,  RECEIVED,  and  USES  statements  is 
the  vehicle  by  which  data  flow  information  is  presented. 


System  structure  must  be  complete  for  obvious  reasons.  The 
STRUCTURE  Report  is  helpful  in  checking  and  representing  the 
information. 

Functional  flow  is  perhaps  the  trickiest  facet  in  the  development 
of  the 'Analyzer  data  base.  Care  must  be  taken  to  insure  that 
a  functional  chain  of  EVENTS,  CONDITIONS  and  PROCESSES  exists 
in  a  meaningful  fashion.  Usage  of  TRIGGERS,  ON  TERMINATION  OF, 

ON  INCEPTION  OF,  TRIGGERS,  HAPPENS,  and  WHEN  Statements  is 
suggested. 

4.3.4  DESCRIPTIONS 


The  documents  should  keep  in  mind  that  in  many  cases  standards 
will  need  descriptions  in  the  form  of  text  on  different  aspects 
..of  systems.  The  DESCRIPTION  statement  can  be  used  by  the 

documentor  to  meet  these  text  requirements.  The  documentor  should 
include  a  DESCRIPTION  with  all  major  sections  of  an  Analyzer 
data  base,  as  well  as  any  other  descriptive  statements  that  are 
deemed  necessary  (i.e.,  PROCEDURE,  VOLATILITY-SET,  etc.) 

4.3.5  Usage  of  KEYWORDS 

When  one  or  more  objects  in  a  system  description  need. to  be  identified  for 
selection  and  analysis  purposes,  KEYWORDS  should  be  attached  to  each  of 
the  objects.  By  doing  this,  the  documentor  has  a  link  between  related 
objects.  For  example,  if  all  functions  (PROCESSES)  described  as  being 
manual  procedures  in  a  system  description  were  to  be  listed  and  analyed 
together,  the  KEYWORD  "manual"  could  be  attached  to  each  PROCESS  for 
this  purpose.  By  doing  a  NAME- GEN  with  the  option  KEY=MANUAL,  a  list 
of  these  PROCESSES  could  then  be  produced. 
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APPENDIX  A  -URA  Command  Abbreviations 


This  appendix  presents  all  URA  commands,  with  their  parameters  and 
defaults.  It  also  presents  the  acceptable  abbreviations  for  these 
commands  and  parameters.  There  are  several  conventions  in  choosing 
these  abbreviations  that  may  aid  the  user: 

1.  For  command  names  that  consist  of  only  one  word,  for 
example,  CONTENTS  or  PICTURE,  the  first  three  or  four 
letters  of  the  name  are  used  as  their  abbreviation. 

CONT  is  the  abbreviation  for  CONTENTS  and  PIC  is  the 
abbreviation  for  PICTURE. 

2.  For  most  command  names  that  consist  of  more  than  one 
word,  e.g.,  CONS I STS -MATRIX  or  FORMATTED-PROBLEM-STATEMENT, 
the  abbreviation  is  derived  by  using  the  first  letter  from 
each  word  in  the  command  name.  This  gives  CM  for  CONSISTS- 
MATRIX  and  FPS  for  FORMATTED-PROBLEM-STATEMENT .  This  con¬ 
vention  is  not  strictly  followed  however,  so  that  the 
abbreviations  may  be  more  meaningful.  For  example,  DCOM 

is  the  abbreviation  for  DELETE -COMMENT- ENTRY  which  is  more 
mnemonic  than  DCE. 

3.  Abbreviations  for  parameters  used  in  the  same  way  by  several 
commands  are  the  same.  The  FILE  parameter  then,  always  has 
an  abbreviation,  F,  allowed  no  matter  which  command  is  using 
it.  Some  of  the  more  common  parameters  are  listed  below: 


Parameter 


Abb  re vi  at  ion 


FILE  F 

NAME  N 

INPUT  I 

NOPRINT  NP 

PUNCH  P 


4.  Whenever  an  abbreviation  exists  for  a  parameter  that  has  a 
"NO"  prefix,  such  as  NOSYNONYMS  or  NOPRINT,  the  abbreviation 
is  always  prefixed  with  "N."  For  example,  NSYN  is  the 
abbreviation  for  NOSYNONYSM  and  NP  is  the  abbreviation  for 
NOPRINT. 

A  blank  entry  in  the  "Parameters"  column  for  a  command  designates  that 
there  are  no  parameters  for  the  command.  A  blank  entry  in  the  "Abbreviations" 
column  designates  that  there  is  no  abbreviation  for  the  command  or  para¬ 
meter  name.  A  blank  entry  in  the  "Defaults"  column  designates  that  there 
is  no  default  for  this  parameter  for  the  given  command. 
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Comnand  Name 


Parameters 


Abbreviations 


Defaults 


CHANGE-TYPE 

FILE 

NAME 

TYPE 

CT 

F 

N 

T 

CONSISTS- COMPARISON 

CNC 

FILE 

F 

FILE 

CONSISTS-MATRIX 

CM 

FILE 

F 

FILE 

NAME 

N 

CONTAINED 

CNTD 

CONSISTS 

CSTS 

CONTENTS 

CONT 

FILE 

F 

FILE 

NAME 

N 

INDEX 

NOINDEX 

NOINDEX 

LEVELS 

LEVELS=ALL 

NCFLAG 

NONCFLAG 

NONCFLAG 

DATA-BASE-STATISTICS 

DBS 

NAMES 

NAMES 

NONAMES 

NUBS 

NUBS 

NONUBS 

NAMNUBS 

NOHAMNUBS 

NONAMNUBS 

SYNONYMS 

SYN 

N0SYN0NYM3 

N  SYN 

NOSYNONYMS 

DATA- PROCESS 

DP 

FILE 

F 

FILE 

NAME 

N 

DATA 

D 

PROCESS 

P 

.  — - - 365 


Command  Name  Parameters  Abbreviations  Defaults 


DELETE 

FILE 

NAME 

DEL 

F 

N 

DELETE- COMMENT- ENTRY 

DCOM 

DERIVATION 

DER 

FALSE-WHILE 

FW 

•  PROCEDURE 

PRCD 

TRUE- WHILE 

TW 

VOLATILITY 

VOL 

VOLATILITY-MEMBER 

VOLM 

VOLATILITY-SET 

VOLS 

FILE 

F 

NAME 

N 

PRINT 

PRINT 

NOPRINT 

NP 

DELETE- PSL 

DPSL 

INPUT 

I 

INPUT 

SOURCE 

S 

SOURCE 

NOSOURCE 

NS 

XREF 

X 

NOXREF 

NX 

NOXREF 

DICTIONARY 

DICT 

FILE 

F 

FILE 

NAME 

N 

INDEX 

NOINDEX 

NOINDEX 

NUM-SPACE 

NS 

NUM-SPACE=2 

DESCRIPTION 

DESC 

DESCRIPTION 

NODESCRIPTION 

NDESC 

KEYWORDS 

KEY 

KEYWORDS 

NOKEYWORDS 

NKEY 

RESPONSIBLE- PD 

RPD 

RESPONSIBLE-PD 

NOivESrONSIBLE  -PD 

NHPD 

SYNONYMS 

SYN 

SYNONYMS 

. . . . 

NOSYNONYMS 

•*'***'  '  J  UU  ‘T1 

Command  Name  '  Parameters  Abbreviations  Defaults 


ENTITY-IDENTIFIER 

l 

FILE 

NAME 

IDENTIFIER 

ENTITY 

El 

F 

N 

I 

E  . 

FILE 

EXTENDED-PICTURE 

EP 

FILE 

F  ’ 

FI^E 

. 

NAME 

N 

INDEX 

NOINDEX 

NOINDEX 

STRUCTURE 

STR 

• 

DATA-FLOW 

DF 

FORWARD 

FWD 

BACKWARD 

BWD 

DOWNWARD 

DOWN 

UPWARD 

UP 

LINKS 

LINKS«1000 

COLUMNS 

COLS 

COLUMNS=119 

ROWS 

ROWS=39 

HORIZONTAL-BOXES 

HB 

VERTICAL- BOXES 

VB 

FORMATTED-PROBLEM-STATEMENT 

FPS 

AliARG 

AM 

AMARG=10 

.  BMARG 

BM 

BMARG=25 

COMMENT 

COM 

COMMENT 

NOCOMMENT 

NCOM 

CMARG 

CM 

CMARG=1 

DEFINE 

DEF 

DEFINE 

NODSFINE 

NDEF 

DESG 

DG 

DESG 

NODES G 

NDG 

EMPTY 

NOEMPTY 

(Cont'd) 
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Command  Kane 


Parameters 


Abbreviations 


Defaults 


FILE 

F 

FILE 

NAME 

N 

HMARG 

HM 

HMARG=1»0 

INDEX 

NOINDEX 

NOINDEX 

NEW- LINES 

NL  ' 

• 

NOWEW-LINES 

NNL 

NONEW-LINES 

NEW-PAGE 

NPG 

NONFW-PAGE 

NNPG 

KONEW-PAGE 

NMARG 

NM 

WMARG*20 

ONE-PER-LINE 

OPL 

ONE-PER-LINE 

SEVER AL-PER-LI HE 

SPL 

• 

PRINT 

PRINT 

NOPRINT 

NP 

PUNCH 

P 

NOPUNCH 

NOPUNCH 

RNMARG 

RM 

RNMARG=70 

SMARG 

SM 

SMARG=5 

FREQUENCY 

FREQ 

HELP 

command-name 

SHORT 

SHORT 

LONG 

• 

IlfPUT-PSL 

IP 

DBREF 

D 

DBREF 

H0D3REF 

ND 

INPUT 

I 

INPUT 

SOURCE 

S 

SOURCE 

NOSOURCE 

NS 

UPDATE 

U 

NOUPDATE 

NU 

NOUPDATE 

XREF 

X 

NOXREF 

NX 

NOXREF 

J>DO 

Command  Name 


Parameters 


Abbreviations  Defaults 


KWIC 


HAKE- GEN 


FILE 

DIF 

F 

FILE 

DIF=20 

NG 

ATTRIBUTE 

ATTR 

NOATTRIBUTE 

NATTR 

NOATTRIBUTE 

ATTRIBUTE-VALUE 

ATTV 

NOATTRIBUTE- VALUE 

NAT TV 

NOATTRIBUTE-VALUE 

CONDITION 

COND 

NOCONDITION 

NCOND 

NOCONDITION 

ELEMENT 

ELE 

NOELEMENT 

NELE 

NOELEMENT 

ENTITY 

ENT 

NOENTITY 

NENT 

NOENTITY 

EVENT 

EV 

NOEVENT 

KEV 

NOEVENT 

GROUP 

GR 

NOGROUP 

NGR 

NOGROUP 

INPUT 

INP 

NOINPUT 

NINP 

NOINPUT 

INTERFACE 

INTF 

NOINTERFACE 

NINTF 

NOINTERFACE 

INTERVAL 

INT 

NOINTERVAL 

NINT 

NOINTERVAL 

KEYWORD 

KEY 

• 

NOKEYWROD 

NKEY 

NOKEYWORD 

MAILBOX 

BOX 

NOMAILBOX 

NBOX 

NOMAILBOX 

MEMO 

NOMEMO 

NMEMO 

NOMEMO 

OUTPUT 

OUT 

NOOUTPUT 

NOUT 

NOOUTPUT 

PR0BLEM-DZFII.7R 

PD 

NOPROBLEM-DEFINER 

NPD 

NOPROBLEM-DEFIHER 

(Com  'a) 
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Abbreviations 


Defaults 


Command  Name 
NAME-GEN  (cont'd) 


(Cent ' C) 

*RE/\L -  V.’OiU .» - ENTITY  i; 


Parameters 


PROCESS 
NOPROCESS 
REAL-WORLD- ENTITY* 
NOREAL-WORLD-ENTITY 
RELATION 
NORELATION 
SECURITY  ' 
NOSECURITY 
SET 
NOSET 
SOURCE 
NOSOURCE 


PROC 

NPROC 

RWE 

NRWE 

RLN 

NRLN 

SEC 

NSEC 


SRC 

NSRC 


SUBSETTING- CRITERION 

j  SSCN 

NOSUBSETTING-CRITERION 

NSSCN 

SYNONYMS  SYN 

NOSYNONYMS  NSYN 

SYSTEM-PARAMETER  SYSP 

NOSYSTEM- PARAMETER  NSYSP 

UNDEFINED  UNDP 

NOUNDEFINED  ITUMDF 


NOPROCESS 

NOREAL-WORLD-ENTITY 

NORELATION 

NOSECURITY 

NOSET 

NOSOURCE 

NOSUBSETTING- CRI TERION 

NOSYNONYMS 

NOSYSTEM-PAR AMSTER 

NOUNDEFINED 


BASIC 

NOBASIC 

EMPTY 

NOEMPTY 

KEY 

IDENTIFIER 

IDENTIFIER-GROUP 

IDENTIFER-ELEMENT 

NONE 

ALL 

ORDER 

PD 

PRINT 


ID 

IDG 

IDE 


BASIC 

EMPTY 


NONE 

ORDER=ALPHA 

PRINT 
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.  nynonymo us  with  INTERFACE* 


rw-.-nund  Name  '  Parameters  Abbreviations  Defaults 


• 

• 

NOPRINT 

PUNCH 

NOPUNCH 

TOTAL 

.  SUBLEVEL 

SUBPARTS-OF 

NP 

P 

SL 

SO 

PUNCH 

e 

SUBLEVEL=0 

NAME-LIST 

NL 

ORDER 

ORDER = ALPHA 

PICTURE 

' 

PIC 

DATA 

D 

DATA 

NODATA 

ND 

FILE 

F 

FILE 

NAME 

N 

FLOW 

FLOW 

NOFLOW 

INDEX 

NOINDEX 

NOINDEX 

STRUCTURE 

STR 

STRUCTURE 

NOSTRUCTURE 

NSTR 

PRI NT- ATTRIBUTE- VALUES 

PAY 

FILE 

F 

FILE 

NAME 

N 

PROCESS-CHAIN 

PC 

$ 

* 

FILE 

F 

FILE 

NAME 

N 

INDEX 

NOINDEX 

NOINDEX 

• 

LINKS 

LINKS=1000 

COLUMNS 

COLS 

COLUMNS=119 

ROWS 

ROWS=39 

HORIZONTAL-BOXES 

HB 

VERTICAL- BOXES 

VB 
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Command  Name 


Parameters 


Abbreviations 


Defaults 


PROCESS-INPUT-OUTPUT 

FRIO 

FILE 

F 

FILE 

NAME 

N 

DESCRIPTION 

DESC 

DESCRIPTION 

NODESCRIPTION 

NDESC 

PROCEDURE 

PRCD 

■ 

NOPROCEDURE 

NPRCD 

NOPROCEDURE 

INPUT 

INP 

INPUT 

NOINPUT 

NINP 

OUTPUT 

OUT 

OUTPUT 

* 

NOOUTPUT 

NOUT 

NEW-PAGE 

NPG 

NONEW-PAGE 

NNPG 

NONEW-PAGE 

PRINT 

PRINT 

* 

NOPRINT 

NP 

INDEX 

—  '  ' 

NOINDEX 

NOINDEX 

PUNCH - CO MME NT- ENTRY 

PCOM 

DERIVATION 

DER 

DESCRIPTION 

DESC 

FALSE-Y, RILE 

FW 

PROCEDURE 

PRCD 

TRUE-WHILE 

w 

VOLATILITY 

VOL 

VOLATILITY -MEMBER 

VOLM 

VOLATILITY-SET 

VOLS 

EMPTY 

NOEMPTY 

FILE 

F 

FILE 

NAME 

N 

PRINT 

PRINT 

NOPRIHT 

NP 

PUNCH 

P 

NOPUNCH • 

NOPUNCH 
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rnrunand  Hame 


Parameters 


Abbreviations 


Defaults 


RENAME 

INPUT 

OLD 

NEW 

REN 

I 

0 

N 

9 

« 

replace-comment-entry 

RCOM 

» 

1 

INPUT 

I 

INPUT 

PRINT 

PRINT 

• 

NOPRINT 

NP 

STRUCTURE 

STR 

INDENT 

IND 

INDENT3 3 

INDEX 

NOINDEX 

NOINDEX 

' 

INPUT 

INP 

1 

* 

INTERFACE 

INTF 

OUTPUT 

OUT 

PROCESS 

PROC 

PROCESS 

REAL-WORLD-ENTITY* 

RWE 

SUMMARY 

SUM 

*  REAL-WORLD-ENTITY  is  synonymous  with  INTERFACE. 
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Appendix  B#  Creating  and  Initializing  URA  data  bases 


Before  the  user  can  add  information  to  a  URA  data  base,  the  data  base 
must  exist  and  be  initialized  properly.  Creating  an  initialized  data 
base  is,  in  general,  a  two-step  process.  Step  one  is  to  create  the 
table-file  containing  a  description  of  the  data  base.  Step  two  is  to 
create  the  data  base  itself.  Several  data  bases  may  be  created  using 
the  same  description,  hence,  step  two  may  be  done  several  times  for  a 
single  table  file  created  in  step  one. 

Step  one  -  Create  Table  File 

The  table  file  contains  a  description  of  the  URA  data  base  which  depends 
on  the  DDL  (Data  Definition  Language)  description  of  the  data  base. 

The  important  aspect  of  this  description  from  the  user  point  of  view  is 
the  number  of  pages  in  the  data  base.  The  first  statement  in  the  DDL 
is  the  number  of  pages  in  the  data  base.  To  create  a  table  file: 

exec_jcom  >udd>project>personid>ddla  name 

where  the  segment  name.ddl  contains  the  ddl  and  the  segment  name.dbt 
will  contain  the  tables.  For  instance,  if  the  user  wished  to  set 
up  a  table  file  for  a  fifty  page  data  base,  he  would  make  a  copy  of  the 
DDL  file 

copy  >udd>proj  ect>personid>psa. ddl  user . ddl 

He  would  then  edit  the  new  DDL  file,  user. ddl,  to  change  the  first  line 
to  read : 

npages  50 

Note  that  the  number  of  pages  must  be  right  justified  in  columns  20-24. 
Once  the  user  has  changed  the  DDL,  he  may  use  ddla  to  create  a  table  file: 
exec_com  >udd>project>personid>ddla  user 

Tliis  would  create  a  segment  named  user.dbt. 


Step  two  -  Data  Base  Initialization 

The  user  may  initialize  an  empty  data  base  segment  using  dbin. 

exec_com  >udd  >proj  ect>personid>dbin  data-base  table-file 

'Hie  data  base  has  a  qualifier  of  ".dbf"  added,  and  the  table  file  has 
a  qualifier  of  ’'.dbt’1  added. 
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For  the  above  example, 

exec_com  >udd>project>personid>dbin  mydb  user 

would  initialize  a  fifty  page  data  base  segment  named  mydb.dbf. 
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Appendix  C.  Durap/Restore  facility 


1 .  Dump . 

To  produce  a  card  image  dump  of  a  data  base: 

exec— com  >udd>project>personid>pdum  data-base  output  punch 
where: 

data-base  is  the  data  base  to  be  dumped  (the  ".dbf"  qualifier  is  added) 
output  is  a  printed  listing  of  the  dump 

punch  is  the  card  image  dump  segment 

2.  Restore 

To  restore  a  previously  dumped  data  base: 

exec_com  >udd>project>personid>pres  data-base  output  input 
where: 

data-base  is  an  empty  initialized  data  base  (the  ".dbf"  qualifier  is  added) 
output  is  a  printed  listing  of  the  input 

input  is  the  punch  segment  from  pdum 
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Appendix  D.  Specification  Generator 


To  execute  the  specification  generator: 

exec_com  >udd>project>personid>spg  schema  source 
where: 

schema  is  the  segment  containing  the  schema 
source  is  the  segment  containing  the  source 
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APPENDIX  E 


Using  the  URA  Command  Language  with  Multics* 
(Version  A2.1  of  URA) 


Contents 


There  are  three  parts  to  this  addendum: 

1)  URA  Control  Commands  for  Multics 

set  Command . . . 

stop  Command  . 

These  commands  can  be  used  when  using  URA  under  Multics  (in 
addition  to  the  other  commands  presented  in  Part  IV). 

2)  Notes  on  Executing  URA  under  Multics  .  .  . 

This  part  explains  how  to  create  and  initialize  a  URA  data 
base  in  Multics  and  how  to  enter  URA  mode  once  in  Multics. 
Example  Multics  runs  are  also  given  to  illustrate  the  manner 
in  which  URA  interacts  with  Multics. 

3)  Default  Segment  Names . . . . 

This  part  presents  the  default  segment  names  used  by  the  URA 
commands  and  referenced  in  Part  IV. 

A  brief  "Multics  Glossary"  is  included  to  define  some  of  the 
terminology  used  in  this  addendum. 


*  For  a  better  understanding  of  Multics,  see  the  Multics  Programmers’ 
Manual  (MPH)  or  Multics  Users'Guide,  Honeywell  Order  No.  AL40. 

*  For  a  more  detailed  explanation  of  how  URA  interacts  with  Multics, 
see  Part  II. 
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Special  Note  Concerning  the  Use  of  URA  on  Multics: 


All  commands  (and  their  abbreviations)  described  in  Part  IV 
must  be  issued  in  lower  case,  Multics  does  not 
recognize  the  upper  case  versions  of  these  commands. 
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Command : 
Purpose: 
Prototype: 
Parameters : 


set 

To  set  various  global  switches 
set  [parameter]... 
data-base (db)=segment  name 


Type:  control  command 
and  paramters. 

t 

Default:  data-base“psa.dbf 


The  data  base  is  the  segment  in  which  the  data  base 
information  is  assembled  and  stored.  This  facility 
allows  the  user  to  change  data  bases  conveniently  and 
quickly.  If  the  "set  data-base"  command  is  not  given, 
the  data  set  "psadb.dbf"  on  the  user’s  working  storage 
is  used. 


dbt=segment  name  Default: 

dbt=>udd>project>personid>psa . dbt 

The  data  tables  used  in  accessing  the  user's  URA  data  base 
may  be  specified  if  other  than  the  normal  default  values. 

When  this  parameter  is  not  used,  the  segment 
>udd>project>personid>psa.dbt  is  used. 


echo(e)-  (°j£) 


Defaults:  echo=off 


With  "echo"  set  equal  to  on,  the  commands  are  printed  on 
the  current  output  device  (term)  as  they  are  encountered. 
This  is  more  desirable  in  batch  (command  is  printed  on 
line  printer)  than  in  on-line  mode  (you  always  see  the 
command  you  type  in) . 


heading(h)=  ^offy  Default:  heading=on 

With  "heading"  set  off,  printing  of  headings  (date,  title, 
page  number,  etc.)  of  each  URA  report  will  be  suppressed. 
Headings  will  be  printed  when  the  switch  is  set  on. 


lines (l)=integer 


Default:  lines=45 


The  number  of  lines  printed  by  URA  per  page  is  set  to  the 
indicated  number.  The  default  number  fits  the  output  to 
an  8-1/2  x  11  inch  page  for  convenient  binding.  "Lines" 
may  take  on  any  value  between  10  and  500. 


mode= 


batch  (b) 
terminal (t)/ 


Default:  modeaterminal 


This  switch  sets  other  switches  particular  to  the  mode 
of  operation  such  as  "prompt"  and  "echo." 


output(o)=segment  name 


Default:  output=term 


This  parameter  specifies  the  data  set  where  all  output 
resulting  from  any  subsequent  URA  commands  should  be  written 
into.  If  no  output  file  is  specified,  all  output  is  written 
at  the  terminal  (term)  (Note:  The  output  is  appended  to 
the  end  of  the  segment  specified.) 


* 
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Examples : 


t parameters (p)«  Default:  parameters-on 

With  "parameters"  set  off,  printing  of  parameters  (in  effect 
in  the  production  of  each  URA  report  generated)  will  be 
suppressed.  Parameters  will  be  printed  when  the  switch  is 
set  on. 

problem-name (pnam)=user-narae  Default:  no  default 

The  "problem-name"  is  the  title  that  goes  on  each  page  of 
the  output.  It  must  be  a  URL  name,  that  is,  it  must  begin 
with  a  letter,  be  no  more  than  30  characters  in  length,  and 
be  composed  of  alphanumeric  characters  with  no  intervening 
blanks. 

prompt (p)=  Defaults:  prompt=on 

If  "prompt"  is  set  to  on,  URA  will  prompt  the  user  for  the 
correct  command  or  parameters  when  an  error  is  encountered. 
With  "prompt"  set  to  OFF,  URA  will  ignore  invalid  commands 
and  parameters  and  proceed  to  the  next  command  or  parameter. 

set  db=psa.dbf  pnam=ura-example 

set  output=term 
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Command: 

stop 

i 

Type:  control  command 

Purpose: 

To  terminate  execution  of 
control  to  Multics. 

the  URA  software  and  return 

Prototype: 

stop 

Parameters: 

None 

. 

Example : 

stop 

*  Issuing  this  command  returns  all  storage  used  by  URA  for  tables, 
scratch  files,  etc.  To  restart  execution  of  URA  after  issuing 
this  command  the  user  must  give: 

exec-com  >udd>project>personid>ura 

If  a  user  leaves  URA  mode  and  enters  Multics  without  use  of  the 
**8 top"  command,  the  user  should  issue  the  Multics  "start"  command 
to  return  to  URA. 
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2.  Notes  on  Executing  URA  under  Multics 


A 


To  create  and  initialize  a  URA  data  base: 
exec-com  >udd>*pro j ec t> personid>db in  databasename 


/ 

databasetables 


where  "databasename"  is  a  segment  name  defined  by  the  user  and 
"databasetables"  is  an  existing  segment  containing  information 
to  initialize  the  data  base.  In  most  instances  the  segment 
>udd>project>personid>psa  can  be  used  as  the  data  base  tables.  If 
any  other  name  is  used,  it  must  also  be  specified  by  the  "dbt" 
parameter  for  the  URA  "set"  command. 


To  run  the  Analyzer  (URA)  and  have  the  ability  to  use  the  URA 
command  language,  the  Multics  command: 


exec-com  >udd>pro j  ec  t>personid  >ura 

must  be  given.  URA  will  prompt  the  user  for  a  URA  command  by 
the  message: 

Enter  command  (and  any  paramters) 

To  specify  the  data  base  and  data  base  tables  to  be  accessed  by 
subsequent  URA  commands  use  the  "set"  command: 

set  data-base=databasename  dbt=database tables 

where  the  two  names  given  were  those  used  in  the  creation  and 
initialization  procedure  above.  When  the  segment  name  is  psadb.dbf 
and  the  data  base  tables  are  contained  in  >udd>project>personid>psa.dbt 
then  the  assignments  are  not  required. 


383 


Example  URA  sessions 


login  Userid 

ec  >udd>project>personid>dbin  mydb 

t 

ec  >udd>project>personid  >ura 
set  db=mydb.dbf  o=temp. print 
input-psl  input=afile.psl  update 

name-gen  all 
fps 
8  top 

dprint  temp. print 
logout 


[login  to  Multlcs] 

>udd>project>personid>ura  \ 

[initialize  an  empty  data  base] 

[enter  URA  mode] 

[set  control  information] 

[update  URA  data  base  using  contents 
of  afile.psl  in  current  working  directory] 

[get  list  of  all  names] 

[get  FPS  for  all  names] 

[leave  URA  mode] 

[print  output  ■  line  printer] 

[logout  of  Multics] 


i 
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A  subsequent  session  may  enter  more  input  and  generate  some  reports 


login  Userid 

ed  >udd>project>personid>ura 

set  db=mydb.dbf  pnam=Multics- 

example 

input-psl  input=somefile .psl  update 

name-gen  process 
picture 

name- gen  all 

fps 

stop 

logout 


[login  to  Multics] 

[enter  URA  mode] 

[set  control  information] 

[update  the  data  base  using  the 
contents  of  somefile.psl] 

[get  list  of  process  names] 

[get  Picture  report  for  each 
process  name] 

[get  list  of  all  names] 

[get  FPS  for  all  names] 

[leave  PSA  mode] 

[logout  of  Multics] 
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3.  Default  Segment  Names 


Table  E-Ip resents  a  summary  of  Multlcs  default  segment  names  used 
In  conjunction  with  each  URA  command.  The  "Default  Input  File" 
is  the  default  segment  used  as  input  to  the  command  if  no  other 
segment  set  has  been  specified  (i.e.,  via,  the  "INPUT®1"  or  "FILE*" 
parameter.)  A  dash  in  the  entry  designates  that  the  command  has  no 
Input  data  parameters. 

The  "Default  PUNCH  File"  is  the  default  segment  used  to  store  PUNCH 
data  from  the  command  if  no  PUNCH  segment  is  designated  via  the 
"PUNCH*"  parameter.  A  dash  in  the  entry  designates  that  no  PUNCH 
data  can  be  obtained  directly  from  the  command.  (PUNCH  data  is  data 
that  is  directly  acceptable  as  input  to  a  URA  command.) 


t 


* 
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Multics  Default  Segment  Names 

4 


Command 

Default  Input  File 

Default  *PUNCH  File 

CHANGE-TYPE 

p  sanarae . uratemp 

— 

CONSISTS-COMP ARISON 

psaname.uratemp 

— 

CONSISTS-MATRIX 

psaname . uratemp 

— 

•  CONTENTS 

psaname.uratemp 

DATA-PROCESS 

psaname . ura  temp 

— 

DELETE 

psaname . uratemp 

— 

DELETE-COMMENT-ENTRY 

psaname.uratemp 

— 

DELETE-PSL 

term 

— 

DICTIONARY 

psaname . uratemp 

— 

ENTITY-IDENTIFIER 

psaname . ura  temp 

— 

FORMATTED-PROBLEM-STATEMENT 

psaname.uratemp 

psafps .psl 

FREQUENCY 

— 

— 

INPUT-PSL 

term 

— 

KWIC 

psaname . uratemp 

— 

NAME-GEN 

— 

psaname . uratemp 

NAME-LIST 

— 

— 

PICTURE 

psaname.uratemp 

— 

PRINT-ATTRIBUTE-VALUES 

psaname.uratemp 

— 

PROCESS-INPUT-OUTPUT 

psaname . uratemp 

— 

PUNCH-COMMENT-ENTRY 

psaname . uratemp 

psapcom. comment 

RENAME 

no  default 

— 

REPLACE-COMMENT-ENTRY 

psapcom. comment 

— 

STRUCTURE 

— 

— 

SUMMARY 

— — 

— 

TABLE  E_1 
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APPENDIX  T 


Schema  for  the  Functional  Description 
Source  for  the  Functional  Description 
Schema  for  the  Data  Requirements  .  . 
Source  for  the  Data  Requirements  .  . 
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II.  FUNCTIONAL  DESCRIPTION 
SSET  D3=SE1 1: NAVY. DBF 
♦HEADING-SKIP  3 
♦TOP-LINES  2  ’ 

♦BOTTOM-LINES  2 

G  THIS  IS  AN  EXAMPLE  DOCUMENTATION  SOURCE  OF  THE  FUNCTIONAL 
G  DESCRIPTION  STANDARDS  FOUND  IN  DOD  MANUAL  4120. 17-M. 

G  IT  IS  WRITTEN  IN  CONJUNCTION  THE  EXAMPLE  DATA  BASE  FOUND 
G  IN  ISDOS  WP  74. 

♦  SKIP  1 

#1.1  PURPOSE  OF  FUNCTIONAL  DESCRIPTION 
♦SKIP  1 

THIS  FUNCTIONAL  DESCRIPTION  FOR  THE  PAYSTATEMENT  EXAMPLE,  PROJECT  #1 
IS  WRITTEN  TO  PROVIDE: 

A.  THE  SYSTEM  REQUIREMENTS  TO  BE  SATISFIED  WHICH  WILL  SERVE  AS  A 
BASIS  FOR  MUTUAL  UN DERSTA NDI NG  BETWEEN  THE  USER  AND  THE  DEVELOPER 

B.  INFORMATION  ON  PERFORMANCE  REQUIREMENTS,  PRELIMINARY  DESIGN,  AND 
USES  IMPACTS,  INCLUDING  FIXED  AND  CONTINUING  COSTS. 

C.  A  BASIS  FOR  THE  DEVELOPMENT  OF  SYSTEM  TESTS. 

#1.2  PROJECT  REFERENCES 

♦SKTP, 1 

THE  PAYROLL  DEPARTMENT  IS  THE  SPONSOR  AND  USER  OF  THIS  MANAGEMENT 
INFORMATION  SYSTEM.  THE  ACTUAL  OPERATION  OF  THIS  SYSTEM  KILL  BE 
HANDLED  BY  BOTH  THE  PAYROLL  DEPARTMENT  ANd’THE  DATA  PROCESSING 
DEPARTMENT. 

♦SKIP  1 

A.  A  COPY  OF  THE  PROJECT  REQUEST  IS  IN  THE  APPENDIX. 

B.  STANDARDS  AND  REFFER2NCE  DOCUMENTATION 

1. ISDOS  WORKING  PAPERS  74,86,90 

2. DOD  ADS  DOCUMENTATION  STANDARDS  MANUAL  4120. 17-M 
♦HEADING-SKIP  61 
#2.  SYSTEM  SUMMARY 
♦SKIP  1 

THIS  SECTION  SHALL  PROVIDE  A  GENERAL  DESCRIPTION,  WRITTEN  IN 
NON-ADP  TERMINOLOGY,  OF  THE  PROPOSED  ADS. 

♦HEADING-SKIP  3 

#2.1  BACKGROUND/PURPOSES  -  . 

♦SKIP  1 

%  PC O M  N=  3 ACKGROUN  D-M  EMO  DESC  NOPUNCH 
#2.2  OBJECTIVES 
♦SKIP  1 

% PCO.M  N=0  3J  ECT I VE3- M  EMO  DESC  NOPUNCH 
#2.3  EXISTING  METHODS  AND  PROCEDURES 
♦SKIP  1 

SINCE  THIS  IS  A  NEW  COMPANY,  THERE  IS  NO  APPLICABLE  EXISTING 
PROCEDURE  FOR  DOING  THE  PAYROLL. 

#2.4  PROPOSED  METHODS  AND  PROCEDURES 
♦SKIP  1 

2PC0M  N=  PR0CES3-M  E.MO  DESC  NOPUNCH 

♦  HO  L  D  4  3 

ftPIC  N= MAIN-PROCESS  NOSTRUCTURE 
♦HEADING-SKIP  2 

#2.4.1  SUMMARY  OF  IMPROVEMENTS 

♦  s;<  ip  i 


A .  5  .....  L  N  G 

♦SKIP  1 

::  pc  p . ;  =  p  a  i  .7 ol  l  -  :>  e  p t  -  i; r.  p  lo  y  2  ls 

♦skip  1 

B.  TIMELINESS 
♦SKIP  1 


DESC  NOPUNCH 


b 
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SO  U RC E 


U  /  “  -  r  J 


f  TV*  TT 


61  %FPS  N=ONE 

62  *2.4.2  SUMMARY  OF  IMPACTS 

63  *SK IP  1 

64  #2. 4.2.1  EQUIPMENT  IMPACTS 

65  *SK IP  1 

66  A  LINE  PRINTER  CAPABLE  OF  PRINTING  CHECKS  IS  NECESSARY. 

67  EQUIPMENT  CAPABILITIES  ARE  DISCUSSED  IN  PARAGRAPH  4.1. 

68  *2. 4.2.2  SOFTWARE  IMPACTS 

69  *SK  IP  1 

70  THERE  ARE  FIVE  BASIC  SOFTWARE  AREAS  WITHIN  THE  PAYROLL  SYSTEM. 

71  *SK IP  1 

72  %N3  SO=MAI N- PROCESS  SL=1 

73  *  HOLD  43 

74  SPIC  N=  M AI N-PROC ESS  NODATA  NOFLOW 

75  #2. 4.2.3  ORGANIZATIONAL  IMPACTS 

76  *SKIP  1 

77  %  FP S  N=RSSPON'SIBILITIES 

78  *  HE A  DI NG-S  KIP  50 

79  #2. 4.2.4  OPERATIONAL  IMPACTS 

80  *HEADI NG-SKIP  2 

81  *  RE  PO  RT-CC  OFF 

82  *  SKI  P  1 

83  A.  OPERATIONAL  STRUCTURE 

84  XSTR 

85  *NSW-PAGS 

86  B.  TIMELINESS  (OPERATIONS  AND  DATA) 

87  *SK IP  1 

83  %FR  EQ 

89  +NSW-PAGE  .  ’ 

90  C.  INPUTS 

91  %ST  R  INPUT 

92  *SKIP  2 

93  D.  DATA  RETENTION 

94  *  SK I P  1 

95  %PCOM  N= MASTER-FILE  DESC  DER  NOPUNCH 

96  *UOLD  43 

97  %?IC  H=M ASTER-FILE  NODATA  NOFLOW 

98  *  NS  A  DI NG -S  KI P  59 

99  #2. 4.2.5  DEVELOPMENT  IMPACTS 

100  *  RE  POKT-CC  ON 

101  *SK IP  1 

102  SFPS  N= COMPLEXITY- LEV  EL 

103  *SK IP  2 

104  %FPS  N=DE VELOPMENT-N  EEDS 

105  *  hS A  D ING- SKIP  3 

106  #2.5  EXPECTED  LIMITATIONS 

107  *SK  I P  1 

108  ERRORS  WILL  BE  NECESSARY  FOR  BAD  DATA  INPUT 

109  *SK IP  1 

110  SPEOM  N= ERROR-LISTING  DESC  NOPUNCH 

111  *HOLD  43 

112  RPIC  N=ERROR-LISTING 

113  *  HO  L  D  4  3 

114  r’PIC  N  "  S/ROR-L  T  "T I  NG  -  ENTRY 

^  1  j  '•  *  i  St  A  L)  x  » o  .j  u  J.  i  )  i 

116  #3.  DETAILED  CHARACTERISTICS 
*117  *  HEADING- SKIP  J 

1 1 8  *  :>.<  i  p  i 

119  #3.1  SPECIFIC  PERFORMANCE  REQUIREMENTS 

120  *  SK I P  1 
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121 

122 

123 

124 

125 

126 

127 

128 

129 

130 

131 

132 

133 

134 

135 

136 

137 

138 

139 

140 

141 

142 

143 

144 

145 

146 

147 

148 

149 

150 

151 

152 

153 

154 

155 

156 

157 

158 

159 

160 
161 
162 


(SEE  SECTION  2) 

♦SKI?  1 

SFP5  N=PAYROLL-PROCESSING 
♦SKIP  2 

DATA  RECEIVED; 

%  NS  INPUT  SET  ORDER=  BYTYPE 
♦SKIP  2 

OUTPUTS  GENERATED; 

♦SKI?  2 
%  N3  OUTPUT 

#3.1.1  ACCURACY  AND  VALIDITY 
♦SKI?  1 

%PCOM  N=ACCURACY-3EMO  DESC  NOPUNCH 

♦  S-K I P  2 

%F?S  N-=  V AUDIT  Y-C HECK 
♦HOLD  43 

%PIC  N =HO URL Y- PAY CHECK- VALIDATION 

♦  NEW- PAGE 

%PIC  N=SALARIED-PAYCHECK- VALIDATION 
4  3.  1.2  TIMING 
♦SKIP  1 

TH 2. FOLLOWING  IS  A  DESCRIPTION  OF  THE  FUNCTIONAL  FLOW. 
♦SKIP  1 

FOR  SALARIED  EMPLOYEES  - 
♦SKIP  1 

%FPS  N  =  SALARIED-E;iP- PROCESSING-IN  IT 

% FP S  N  =  VALIDIT  Y-CHECK 

%FPS  N=P ASS  ED- ERROR-CHECKS 

%F?S  N  =  SAL ARIE  D-P A YCHECK- PROD-I NIT 

♦SKIP  2 

FOR  HOURLY  EMPLOYEES  - 
♦SKIP  1 

%FPS  N=HOURLY-EMP-?ROCESSING-INIT 

%FPS  N=VALIDITY-CHECK 

*FPS  N=TIM  E-CARD- MIS  SING 

S FP  S  N=PASS  ED- ERROR- CHECKS 

AFP S  N=HOURLY- PA YCHECK- PROD-I NIT 

%FPS  N=  N EW- EMPLOY  EE- PROCESS  IN G- IN  IT 

XFPS  N  =  TER  M I N A TION- PROCESSING -I  NIT 

♦HEADING-SKIP  59 

#3.2  SYSTEM  FUNCTIONS 

♦HEADING-SKIP  3 


163  ♦REPORT-CC  OFF 


J 

J> 

164 

♦SKIP 

i 

165 

/o  NG  SO 

=M AIN-PROCESS  SL= 1  NOPRINT 

\ 

166 

♦  SKIP 

1 

i 

i 

167 

THE 

VARIOUS  SUB- FUNCTIONS  OF  THE 

168 

♦  SKIP 

1 

■» 

169 

XPCOM 

DESC 

PRCD  NOPUNCH 

i 

170 

#3.3  INPUTS/OUTPUTS 

> 

171 

♦  5K  IP 

1 

4 

i 

172 

INPUT 

5  Z 

173 

♦SKIP 

1 

< 

174 

zm  input 

NOPRINT 

1  7  r’ 

*  ■> 

W- 

176 

♦SKI  P 

2 

177 

OUTPUTS: 

17  8 

♦  SKIP 

1 

179 

A  ii  j  0  U 

TP  u  r 

NOPlUN f 

180 

•>:  b  p  s 

SYSTEM  ARE: 


1 


1 


i 

i 


(*  /  XI »  • 


1 1  it  r' 
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181  ♦SKIP  2 

182  %STR  OUTPUT 

183  #3.4  DATA  CHARACTERISTICS 

184  ♦REPORT-CC  OH 
35  ♦SKIP  1 

1 8 6  %FPS  N  =  PAYROLL- MASTER-INFORMATION 
1 U7  ♦SKIP  2 

188  &  THE  FOLLOWING  LINES  ARE  EXCLUSIVE  TO  THIS  DOCUMENT 

189  PC 0 M  N=  DEPARTMENT-FILE  DESC  DER  VOLS  NOPUNCH 

190  *SK IP  1 

,  191  SPCOM  N=HOURLY- EMPLOYEE- FILE  DESC  DER  VOLM  NOPUNCH 

192  ♦HOLD  43 

193  IPIC  N=HOURLY-EMPLOYES-FILE 

194  ♦NEW-PAGE 

195  %PCOU  N=SALARIED-EMPLOYSS-FILE  DESC  DER  YOLM  NOPUNCH 

196  *  HOLD  43 

197  EPIC  N=SALARIED-EMPLOYE5-FILE 

198  #3.5  FAILURE  CHARACTERISTICS 

199  ♦ SK I P  1 

200  SPCOM  N  =  8  A  C  K  U  P  - 1 1 E  M  0  DESC  NOPUNCH 

201  *HEADING-SKIP  61 

202  #4.  ENVIRONMENT 

203  ♦HEADING-SKIP  3 

204  ♦SKI?  1 

205  #4. 1  EQUIPMENT  ENVIRONMENT 

206  ♦SKI?  1 

207  3PCOM  N= EQUIPMENT -MEMO  DESC  NOPUNCH 

208  #4.2  SUPPORT  SOFTWARE  ENVIRONMENT 

209  ♦SKIP  2  .  * 

210  %PCOH  N  =  SOPTWARE-MEMO  DESC  NOPUNCH 

211  #4.3  INTERFACES  -• 

212  ♦SKIP  1 

213  3STR  RWE 

214  ♦HOLD  43 

215  5SPIC  N=  ACCO UNTING -SYST EMS 

216  * NEW- PAGE 

217  *PIC  N=  PA YROLL -DEPARTMENT 

218  #4.4  SECURITY 

219  ♦RSPDRT-CC  OFF 

220  *SK IP  1 

221  SPCOM  N=3  ECU RITY- MEMO  DESC  NOPUNCH 

222  %NG  SEC  NOPRINT 

223  %FPS 

224  ♦HEADING-SKIP  61 

225  #5.  COST  FACTORS 

226  SPCOM  N  =COS TS- MEMO  DESC  NOPUNCH 

227  #6.  DEVELOPMENT  PLAN 

228  ♦SKIP  1 

229  %  PC  O  M  N=  DEVOLPM  ENT-M  EMO  DESC  NOPUNCH 

230  *  SK IP  2 

231  XFPS  N  =  DEVELOP M ENT-TIMES 


'p:c 
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Schema  for  the  Data  Requirements 


« 


-SCHEMA 


07-24-75  16:12:55  SCHEMA  1 


1  *TI TLE  DATA  REQUIREMENTS  DOCUMENT 

2  * HE A DING- MARGIN  3 

3  *  LI N  ES  50 

411.  GENERAL  DATA  REQUIREMENTS 

5  &  THIS  IS  AN  EXAMPLE  DOCUMENTATION  SCHEM  OF  THE  DATA 

6  5  REQUIREMENTS  DOCUMENT  FOUND  IN  DOD  MANUAL  4120. 17-M 

7  #1.1  PURPOSE  OF  DATA  REQUIREMENTS 

0  #1.2  PROJECT  REFERENCES 

9  #1.3  MODIFICATION  OF  DATA  REQUIREMENTS 

10  » 2.  DATA  DESCRIPTION 

11  *2. 1  LOGICAL  ORGANIZATION  OF  STATIC  SYSTEM  DATA 

12  #2.2  LOGICAL  ORGANIZATION  OF  DYNAMIC  INPUT  DATA 

13  #2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 

14  #2.4  INTERNALLY  GENERATED  DATA 

15  #2.5  SYSTEM  DATA  CONSTRAINTS 

'W1 6  #3.  USER  SUPPORT  FOR  DATA  COLLECTION 

17  #3.1  DATA  COLLECTION  REQUIREMENTS  AND  SCOPE 

18  #3.2  RECOMMEND  SOURCE  OF  INPUT  DATA 

19  #3.3  DATA  COLLECTION  AND  TRANSFER  PROCEDURES 

20  #3.4  DATa  BASE  IMPACTS 
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Source  for  the  Data  Requirements 


1  #1.  GENERAL  DATA  REQUIREMENTS 

2  G  THIS  IS  AN  EXAMPLE  DOCUMENTATION  SOURCE  OF  THE  DATA 

3  G  REQUIREMENTS  DOCUMENT  FOUND  IN  DOD  MANUAL  4120. 17-M 

4  #1.1  PURPOSE  OF, DATA  REQUIREMENTS 

5  *SK I?  1 

6  * SOURCE- MARGIN  1 

7  THE  OBJECTIVES  OF  THIS  DATA  REQUIREMENTS  DOCUMENT  FOB  THE 

8  PAY3TATEMENT  EXAMPLE,  PROJECT  *1  ARE  TO  LIST  AND  DEFINE  DATA 

9  ELEMENTS  WHICH  THE  SYSTEM  MUST  HANDLE  AND  COMMUNICATE  DATA 

10  COLLECTION  REQUIREMENTS  TO  THE  USER. 

11  #1.2  PROJECT  REFERENCES 

12  *SKI?  1 

13  *SET  D3=S21  1: NAVY. D3F 

14  SPCOM  N=03J ECTI V ES-MEMO  DESC  NOPONCH 

15  ♦SKIP  1 

16  iSPC  0  M  N=  PAYROLL -DEPARTMENT  DESC  NOPUNCH 

17  #1.3  MODIFICATION  OF  DATA  REQUIREMENTS 

18  *  SKI  P  1 

19  NOT  APPLICABLE  TO  THIS  PROJECT. 

20  ♦HEADING-SKIP  61 

21  #2.  D^TA  DESCRIPTION 

22  *  SK I P  1 

23  ♦SOURCE-MARGIN  5 

24  ♦ilEADI  NG-SXIP  2 

25  THE  DATA  DESCRIBED  IN  THIS  SECTION  SHALL  BE  SEPERATED  INTO  TWO 

26  CATEGORIES,  STATIC  DATA  AND  DYNAMIC  DATA.  STATIC  DATA  IS  DEFINED 

27  AS  THAT  DATA  WHICH  IS  USED  MAINLY  FOR  REFERENCE  DURING  SYSTEM  OP- 

28  ERAi’ION  AND  IS  USUALLY  GENERATED  OR  UPDATED  IN  WIDELY  SEPERATED 

29  TIME  FRAMES  INDEPENDENT  OF  NORMAL  SYSTEM  RUNS.  DYNAMIC  DATA  IN- 

30  CLUDES  ALL  DATA  WHICH  IS  INTENDED  TO  BE  UPDATED  AND  WHICH  IS 

31  INPUT  TO  A  SYSTEM  DURING  A  NORMAL  RUN  (INCLUDING  "REAL  TIME"  DATA 

32  SUCH  AS  TARGETING  DATA)  OR  IS  OUTPUT  BY  THE  SYSTEM.  STATIC  DATA 

33  AS  DESCRIBED  ABOVE  IS  FREQUENTLY  REFERRED  TO  AS  PARAMETRIC  DATA 

34  AND  DYNAMIC  DATA  AS  NON -PARAMETRIC  DATA.  BOTH,  HOWEVER,  ARE  COM- 

35  POSED  OF  DATA  ELEMENTS.  THE  DATA  ELEMENT  NAMES  LISTED  IN  PARA- 

36  GRAPHS  2.1,2 .2,  AND  2.3  SHALL  3E  THOSE  CONTAINED  IN  STANDARD 

37  DATA  ELEMENT  LIBRARIES,  WHENEVER  APPLICABLE. 

38  #2. 1  LOGICAL  ORGANIZATION  OF  STATIC  SYSTEM  DATA 

39  ♦SKIP  1 

40  ^CONTENTS  N= MAST ER- FIL E 
4  1  ♦SKIP  1 

42  ^CONTENTS  N=DEPT-FILE 

43  ♦SKIP  1 

44  ^CONTENTS  N=H-£MP-FILE 

45  ♦SKIP  1 

46  ^CONTENTS  N=S-EMP-FILE 

47  #2.2  LOGICAL  ORGANIZATION  OF  DYNAMIC  INPUT  DATA 
40  *  SK I P  1 

49  * REPORT-CC  OFF 

50  S 0=  E vi P — 1 51 FO  S L=  1  NOPRINT 

51  ^CONTENTS 

52  #2.3  LOGICAL  ORGANIZATION  OF  DYNAMIC  OUTPUT  DATA 
63  ♦REPORT-CC  ON 

>  1 

33  ^CONTENTS  N=PA Y- STAT EMENT 
56  ♦SKIP  1 


/ 

3  „ 

59 
6  0 


C  ;  ,i 
♦  oK  I X* 

ICO  NT 
♦SKI  L» 


n  r ; 

i 

NTS 

1 


N=uOUHL  Y  —  ulM'LO  i  EH— P  EPOS  T 

N=SALAR I  ED- EMPLOYEE- REPORT 
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61  ^CONTENTS  N  =  HIR  ED- EMPLOY  EE- REPORT 

62  *SK I P  1 

63  ^CONTENTS  N  =  TER MI N  AT  ED- EMPLOY  EE- REPORT 

64  #2-4  INTERNALLY  GENERATED  DATA 

65  *5K IP  1 

66  %CO NT E NTH  N=ERROR-LISTING 

67  #2-5  SYSTEM  DATA  CONSTRAINTS 

68  ♦  SK I  P  1 

69  XFPS  N  =1-0- CON  STR AINTS- MEMO 

70  ♦  ilEADI  NG-SKIP  61 

71  #3.  USER  SUPPORT  FOR  DATA  COLLECTION 

72  *HE ADI NG-SKIP  2  i 

73  SNG  INPUT  OUTPUT  0RD£R=3YTYPE  NOPRINT 

74  %C'IC 

75  *  NEW- PAGE  i 

76  INFORMATION  IN  REGARDS  TO  DATA  FLOW 

77  ,'>DP  D 

7 d  SN3  ENTITY  NOPRINT 

79  *I1EW-PAGE  ! 

80  INFORMATION  ON  RECORDS  KEPT 

81  ICNC 

82  *  HOL'D.  59 

8 J  *3.  1  DATA  COLLECTION  REQUIREMENTS  AND  SCOPE 
84  *  SK I  P  1 

35  INFORMATION  NEEDED  IN  ORDER  TO  ESTABLISH  THE  VALUES 

86  OF  EACH  DATA  ELEMENT:  *  ] 

87  ♦SKIP  2  j 

83  SPPS  N  =  SALASIED- EMPLOY  ME NT -FORM  j 

89  ZFPS  N=HOURLY- EMPLOYMENT-FORM 

90  XFPS  U= TAX- WITH HOLDING- CERTIFICATE 

91  XFPS  N=EMPLOYMSNT-TERMI NATION- FORM  j 

92  ♦  SKIP  2  I  | 

93  INFORMATION  TO  BE  COLLECTED  BY  THE  USER: 

94  ♦SKIP  1  | 

95  XFPS  N  =  T I M E- C A R D 

96  ♦SKIP  2 

97  OTHER  SUPPLEMENTARY  INFORMATION: 

98  ♦ SKI ?  1 

99  A. INPUT  SOURCE  (S)  OF  THE  DATA  ELEMENT 

100  ♦SKIP  1 

101  iFPS  N=DEPARTMENTS-AND-EMPLOYEES 

102  XFPS  N= EMPLOYEE 

10J  XFPS  N=PAYROLL- DEPARTMENT 

104  ♦SKIP  2 

105  B.  RECIPIENTS 

106  ♦SKIP  1 

107  XFPS  M= ACCOUNTING- SYSTEMS 

103  ♦SKIP  2  , 

109  D.  CRITICAL  VALUES 

110  XPPS  S= RE  MAI NI NG- FUN DS 

111  *  SK  IP  2 

112  E .  OUTPUT  FORM/DEVICE 

113  ‘SKIP  1 

11  *  SPCOM  !«=  I -EM  P- REPORT  DESC  NOPUNCH 
1  1  :>  *  SK  I  ?  1 

“-'H  .-G-EMP-UtPOnT  DISC  NoPUNCti 

I  1  7  ♦SK IP  2 

r  JHNCY  OF  UPDATE 

II  |  ••  F.<  Cj 

W/)  RECOMMENDED  SOURCE  OF  INPUT  DATA 
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I 


121  ♦SKIP  1 

122  THIS  TOPIC  HAS  BEEN  DISCUSSED  ABOV E (SECT ION  3.1. A) 

'  23  *3.3  DATA  COLLECTION  AND  TRANSFER  PROCEDURES 

"-<24  ♦SKIP  1 

125  THIS  TOPIC  HAS  BEEN  DISCUSSED  ABO VE  (SECTION  3.1.F) 

126  *3.4  DATA  BASE  IMPACTS 

127  *3K I P  1 

128  *PCOM  N=  DEPART  M ENT- FILE  DESC  DER  VOLS  NOPUNCH 

129  A>  PCO  M  N  =  HOURLY- EMPLOY  EE- FILE  DESC  DER  VOLM  NOPUNCH 

' 130  SPCOH  N= SALARIED- EM PLOY  EE- FILE  DESC  DER  VOLM  NOPUNCH 


\ 
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‘  APPENDIX  G 

0 

i 

Examples  of  the  Automated  Documentation  System  * 

This  appendix  contains  examples  of  the  Functional  Description  and 
Data  Requirements  Document  written  using  the  Automated  Documentation 
System.  Included  are  the  schemas  and  source  data  bases  used  to 
produce  these  documents.  The  Analyzer  data  base  used  is  the  Pay 
System  example  described  in  Part  IV  .*  Due  to 

6pace  limitations,  listings  of  the  Analyzer  data  base  are  not 
included. 


J 

-  1 


;i 

.  4 
fc  1 

‘  4 

i 


? 


Cl 

t 

-i 

£ 


1 


The  following  list  of  Analyzer  commands  have  been  used  to  produce 
these  examples: 


--Command  Name 

vt - 


Parameters  Used 


CONTENTS 


FILE 

NAME 


.4 

i 


DATA  PROCESS  DATA 

FILE 

FPS  NAME 

FILE 

PRINT 

FREQUENCY 

NAME-GEN  ENTITY 

INPUT 
OUTPUT 
-  PRINT 
NOPRINT 

"  '  SUBLEVEL 

SUBPART  OF 
SECURITY 

PICTURE  DATA 

NODATA 

FILE 

NAME 

FLOW 

NOFLOW 

STRUCTURE 

NOSTRUCTURE 


*  IVer  Rc-qu  i )  ts  An.-.ly.’.r  Cor.  .  Description. 
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Command  Name 


Parameters  Used 


PUNCH-COMMENT-ENTRY  DER 

DESC 

PROC 

VOLM 

VOLS 

FILE 

NAME 

NOPUNCH 

PRINT 

STRUCTURE  INPUT 

PROCESS 

'  RWE 

OUTPUT 

Although  these  are  the  only  commands  used,  all  Analzyer 
commands  may  be  used  with  the  Automated  Documentation 
Generator  (with  the  exception  of  the  STOP  command). 
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PROPOSED  METHODS  AND  PROCEDORES 
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AT  A  U AS  E  IMPACTS 


APPENDIX  H 


Execution  of  the  Documentation  Generator  In  a  Specific  Machine 

Environment  , 

Using  Multics,  the  Automated  Documentation  System  can  run  using  the 
following  command: 


exec-com  >udd>project>personid>spg  schema- segment  source-segment 


This  command  will  do  all  syntax  checking  needed  and  generate  the 
document.  Output  for  the  document  will  go  to  the  file  spg. output. 
The  system  assumes  the  Analyzer  data  base  is  in  the  file  psadb.dbf 
unless  the  SET  command  is  used  to  change  the  default  (i.e.,  SET  DB= 
file)  . 


Output  from  this  section  looks  as  follows: 


LINE  TEXT  CMNDS  SECTION 


2 

& 

3 

&  A  SMALL  TEST  EXAMPLE 

4 

& 

5 

0 

0 

•1.  SCOPE 

6 

0 

2 

=1.1  IDENTIFICATION 

7 

0 

1 

=1.2  FUNCTIONAL  SUMMARY 

8 

*MISSING* 

=1.3 

9 

=1.4 

***  INVALID 

SECTION 

IDENTIFIER 

10 

& 

11 

0 

0 

=2.  APPLICABLE  DOCUMENTS 

12 

13 

2 

=2.1  GOVERNMENT  DOCUMENTS 

13 

5 

1 

=2.2  NON-GOVERNMENT  DOCUMENTS 

SUMMARY 

8  SECTIONS 

1  OF  WHICH  ARE  MISSING  FROM  THE  SOURCE  FILE. 
18  TOTAL  TEXT  LINES,  AND 
6  TOTAL  COMMAND  LINES. 
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GLOSSARY 


analyst  Name  used  synonymously  for  "problem  definer."  One 


who  aids  to  develop  the  problem  statement  or  logical 
system  design. 

Analyzer 

Synonym  for  "URA".  Is  the  software  package  that 

¥ 

comment  entry 

f 

processes  problem  stated  in  the  Language. 

The  text  associated  with  a  comment  entry  statement. 
DESCRIPTION,  PROCEDURE  and  VOLATILITY  are  examples 

-  comment  entry 

statement 

of  statements  which  are  specified  by  comment  entries. 

Any  URL  statement  in  which  the  contents  of  the 
statement  are  defined  by  the  problem  definer  (as 
is  narrative  description).  The  DESCRIPTION  and 
PROCEDURE  statements  are  examples  of  this. 

control  commands  Those  URA  commands  which  allow  the  URA  user  to  pass 


conversational 

mode 

certain  control  information  to  the  Analyzer.  They 
are  particular  to  an  individual  operating  system. 

Interactive  use  of  the  computer  system  through  a 
terminal  device.  Used  synonymously  with  on-line 
terminal,  or  interactive  mode. 

data  base 

The  data  base  referred  to  throughout  this  paper 
is  the  user*s  data  base  which  is  populated  by 

URA.  from  the  user  inputted  URL  statements. 

data  object 

Any  URA  name  type  that  represents  some  form  of  data. 
SETS,  INPUTS,  OUTPUTS,  ENTITIES,  GROUPS  and  ELEMENTS 
are  all  data  objects  described  by  URL. 

fdn&me 

Any  legal  file  or  device  name.  Allowable  names 
are  dependent  on  the  operating  system  being  used. 

filename 

Any  legal  temporary  or  permanent  file  name  that 
is  to  be  specified  by  the  user. 

input  file 

Any  temporary  or  permanent  file  which  contains 
data  to  be  used  by  URA  commands  via  INPUT  or 

FILE  parameters. 

£  logical 

description 

logical  system 
design  . 

Synonym  to  "problem  statement.”  Set  of  requirements 
for  a  new  system. 

The  process  of  specifying  a  problem  statement  for  any 
particular  system. 

485 


modifier  commands 

Multi cs  Command 

Multi cs  Command 
Language 

name  type 


physical  system 
design 


physical  system 
designer 


problem  definer 


problem  statement 


prompt 


PUNCH  file 


report  commands 


Commands  which  modify  the  contents  of  a  URA 
data  base  in  the  manner  specified  by  the  user. 

A  command  to  the  Multics  system;  and  element 
of  the  Multics  command  language. 

The  set  of  commands,  subcommands  and  operands 
recognized  by  the  Multics  Operating  System. 

Any  of  the  many  types  of  names  allowed  by  URL 
(i.e.,  PROCESS,  SET,  GROUP,  etc.).  See  ,TThe 
User  Requirements  Language,  Language  Reference 
Manual1'**,  Appendix  E,  for  a  list  of  all  possible 
name  types. 

The  process  of  specifying  a  physical  system  (con¬ 
sisting  of  software,  machinery,  etc.)  given  a 
particular  problem  statement. 

Person  responsible  for  deriving  a  physical  system 
design  form  the  problem  statement  generated  from 
the  logical  system  design  process. 

Used  synonymously  with  "analyst."  That  person 
who  develops  the  requirements  stated  by  the 
users  into  a  format  understandable  by  others 
and  in  sufficient  detail  to  be  usable  by  the 
physical  system  designer.  The  product  of  his 
work  is  the  problem  statement. 

A  set  of  requirements  specified  by  users  of  a 
proposed  system  and  expressed  by  the  problem 
definer  into  a  format  acceptable  by  the  organi¬ 
zation. 

A  system  function  that  requests  the  terminal 
user  to  supply  operands  necessary  to  continue 
processing. 

A  file  which  contains  data  (usually  URL  user- 
names)  in  a  format  that  can  be  used  as  input 
to  one  or  more  URA  commands. 

Those  commands  which  retrieve  data  from  a  URA 
data  base  and  output  it  in  some  meaningful  format. 


segment  A  named  collection  of  data  which  is  accessible 

by  the  system.  The  data  set  usually  resides  on 
an  auxiliary  storage  device. 
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term 

Identifier  to  designate  that  the  terminal  is  to 
be  used  as  a  source  of  input  or  area  for  output. 

undefined  name 

A  name  of  a  URL  object  that  has  been  entered  into 
the  URA  data  base,  but  has  no  name  type  associated 
with  it. 

URA 

The  User  Requirements  Analyzer.  A  software 
package  which  stores  information  in  the  URA 
data  base  by  interpretting  URL  statements  given 
as  input,  and  retrieves  information  from  the  data 
base  in  the  form  of  reports. 

URA  command 

Any  of  the  commands  that  can  be  used  to  operate 

URA.  See  "User  Requirements  Analyzer  Command 
Descriptions"*  for  complete  descriptions  about 
each  command  available  in  URA. 

URA  data  base 

File  where  URL  information  is  stored  (in  a  coded 
format)  which  can  then  be  accessed  by  URA  commands. 

URL 

The  User  Requirements  Language.  The  collection 
of  all  URL  statements  allowed  for  use  by  URA.  See 
"The  Problem  Statement  Language,  Language  Reference 
Manual"**  for  complete  description. 

URL  statement 

A  statement  specified  by  "The  User  Requirements 
Language,  Language  Reference  Manual"**.  Each 
statement  may  define  a  URL  object,  define  a 
comment  entry,  or  define  a  relationship  among 
two  or  more  URL  objects. 

user-name 

Any  legal  URL  name  specified  by  problem  definer. 
Also  called  a  "user  defined  name." 

*  Part  IV. 
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